Αιτήματα ανά λεπτό
30 αιτήματα/λεπτό σε συνεχή βάση (ριπή: 30). Η υπέρβαση επιστρέφει 429 rate_limited με κεφαλίδα Retry-After.
Το REST API του InstantProof σάς επιτρέπει να πιστοποιείτε οποιοδήποτε δημόσιο URL προγραμματιστικά. Ταυτοποιηθείτε με κλειδί API τύπου Bearer, στείλτε με POST ένα URL και λάβετε υπογεγραμμένο πιστοποιητικό PDF με πλήρες πακέτο αποδεικτικών — με την ίδια χρονοσφραγίδα RFC 3161 και υπογραφή Ed25519 όπως στη διεπαφή ιστού.
Αποθηκεύστε μια ιστοσελίδα, καταγράψτε μια συνεδρία προγράμματος περιήγησης ή πιστοποιήστε ένα αρχείο.
Μια κρυπτογραφική σφραγίδα και χρονοσήμανση βοηθούν να αποκαλυφθούν μεταγενέστερες αλλαγές.
Οποιοσδήποτε μπορεί να ελέγξει ανεξάρτητα το πακέτο αποδεικτικών.
Ξεκινήστε με πίστωση καλωσορίσματος €10. Αποκτήστε ένα κρυπτογραφικά σφραγισμένο πακέτο αποδεικτικών που μπορείτε να κατεβάσετε και να επαληθεύσετε.
Τρία βήματα από το μηδέν έως ένα υπογεγραμμένο πιστοποιητικό PDF.
Συνδεθείτε, μεταβείτε στο Προγραμματιστές → Κλειδιά API και πατήστε Δημιουργία κλειδιού API. Αντιγράψτε το κλειδί — εμφανίζεται μόνο μία φορά.
Στείλτε ένα αίτημα POST με το URL σας:
curl -X POST https://secure.instantproof.legal/api/v1/certificates \
-H "Authorization: Bearer ip_live_xxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com/page-to-certify"}'
Απάντηση 201 Created:
{
"certificateId": "abc123…",
"recordingId": "def456…",
"url": "https://example.com/page-to-certify",
"finalUrl": "https://example.com/page-to-certify",
"status": "ready",
"links": {
"self": "/api/v1/certificates/def456…",
"certificate": "/api/v1/certificates/def456…/download"
}
}
Ακολουθήστε το URL links.certificate με το κλειδί API σας. Ο διακομιστής επιστρέφει ανακατεύθυνση 302 προς ένα προϋπογεγραμμένο URL λήψης:
curl -L \
-H "Authorization: Bearer ip_live_xxxxxxxxxxxxxxxx" \
"https://secure.instantproof.legal/api/v1/certificates/def456…/download" \
-o certificate.pdf
Το PDF που κατεβάζετε είναι το ίδιο υπογεγραμμένο πιστοποιητικό PDF που παράγει η διεπαφή ιστού, και μπορεί να επαληθευτεί στο /certificate.html.
Βασικό URL: https://secure.instantproof.legal
Όλα τα endpoints επιστρέφουν JSON. Ταυτοποίηση: Authorization: Bearer <key>.
Δημιουργεί ένα νέο πιστοποιητικό ιστότοπου. Η πλατφόρμα αποτυπώνει το URL σε πρόγραμμα περιήγησης χωρίς γραφική διεπαφή, παράγει αρχείο καταγραφής δικτύου HAR και στιγμιότυπο οθόνης, υπογράφει το μανιφέστο με Ed25519 και το αγκιστρώνει σε εγκεκριμένη χρονοσφραγίδα RFC 3161. Η λειτουργία διαρκεί 10–60 δευτερόλεπτα.
| Πεδίο | Τύπος | Περιγραφή | |
|---|---|---|---|
url | string | υποχρεωτικό | Ένα έγκυρο URL https:// προς πιστοποίηση. Πρέπει να είναι δημόσια προσβάσιμο. |
| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
certificateId | string | Αναγνώσιμο από τον άνθρωπο αναγνωριστικό πιστοποιητικού (εμφανίζεται στο PDF). |
recordingId | string | Εσωτερικό UUID της καταγραφής. Χρησιμοποιήστε το σε επόμενες κλήσεις API. |
url | string | Το URL που υποβάλατε. |
finalUrl | string | Το URL μετά από τυχόν ανακατευθύνσεις, όπως το είδε το πρόγραμμα περιήγησης. |
status | string | "ready" — το πιστοποιητικό είναι άμεσα διαθέσιμο. |
links.self | string | Διαδρομή για την ανάκτηση των μεταδεδομένων αυτού του πιστοποιητικού. |
links.certificate | string | Διαδρομή για τη λήψη του PDF. Απαιτεί ταυτοποίηση. |
| Κατάσταση | σφάλμα | Σημασία |
|---|---|---|
| 400 | invalid_url | Το πεδίο url λείπει ή δεν είναι έγκυρη διεύθυνση https://. |
| 400 | invalid_json | Το σώμα του αιτήματος δεν είναι έγκυρο JSON. |
| 401 | invalid_api_key | Λείπει η κεφαλίδα Authorization ή δεν είναι έγκυρη. |
| 402 | api_access_required | Ο λογαριασμός σας δεν διαθέτει το πακέτο Pro. Εγγραφείτε. |
| 403 | subscription_required | Τα πιστοποιητικά ιστού απαιτούν συνδρομή πάγιας χρέωσης. |
| 403 | insufficient_scope | Το κλειδί API δεν διαθέτει το εύρος certificates:write. |
| 413 | payload_too_large | Το σώμα του αιτήματος υπερβαίνει τα 64 KB. |
| 429 | quota_exceeded | Συμπληρώθηκε η ημερήσια ποσόστωση λήψεων API. Επαναφέρεται κάθε ημέρα. |
| 429 | rate_limited | Πάρα πολλά αιτήματα. Δείτε την κεφαλίδα Retry-After. |
| 429 | service_busy | Η υπηρεσία λήψης λειτουργεί στο όριο της χωρητικότητάς της. Δοκιμάστε ξανά μετά από ~30 δευτερόλεπτα. |
| 502 | capture_failed | Το πρόγραμμα περιήγησης δεν μπόρεσε να φορτώσει το URL. |
| 502 | certification_failed | Η λήψη δεν παρήγαγε αξιοποιήσιμα αποδεικτικά στοιχεία (π.χ. κενό HAR). |
Ανακτά τα μεταδεδομένα ενός πιστοποιητικού που δημιουργήσατε προηγουμένως.
| Παράμετρος | Περιγραφή | |
|---|---|---|
recordingId | υποχρεωτικό | Το recordingId που επιστρέφεται από το POST /api/v1/certificates. |
| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
certificateId | string | Αναγνώσιμο από τον άνθρωπο αναγνωριστικό πιστοποιητικού. |
recordingId | string | Εσωτερικό UUID της καταγραφής. |
type | string | Τύπος καταγραφής (π.χ. "webcapture"). |
status | string | "ready" μόλις το πιστοποιητικό είναι διαθέσιμο. |
url | string | Το URL που πιστοποιήθηκε. |
createdAt | string | Χρονοσφραγίδα δημιουργίας ISO 8601. |
links | object | Διαδρομές self και certificate. |
Κατεβάζει το υπογεγραμμένο πιστοποιητικό PDF. Επιστρέφει 302 Found — ακολουθήστε την ανακατεύθυνση για να λάβετε το αρχείο. Χρησιμοποιήστε curl -L ή requests.get(..., allow_redirects=True).
Όλα τα αιτήματα API πρέπει να περιλαμβάνουν:
Authorization: Bearer ip_live_xxxxxxxxxxxxxxxx
Τα κλειδιά δημιουργούνται στο Ρυθμίσεις → Προγραμματιστές → Κλειδιά API. Ένα κλειδί ταυτοποιεί τον λογαριασμό σας — αντιμετωπίστε το σαν κωδικό πρόσβασης. Ανακαλέστε το αμέσως εάν διαρρεύσει.
Τα κλειδιά έχουν το πρόθεμα ip_live_ για ενεργούς λογαριασμούς. Το πρόθεμα σάς βοηθά να τα εντοπίζετε στον κώδικα ή σε αρχεία περιβάλλοντος.
30 αιτήματα/λεπτό σε συνεχή βάση (ριπή: 30). Η υπέρβαση επιστρέφει 429 rate_limited με κεφαλίδα Retry-After.
Το πακέτο Pro παρέχει σταθερό αριθμό δημιουργιών πιστοποιητικών ανά ημέρα. Η ποσόστωση επαναφέρεται κάθε ημέρα. Η υπέρβασή της επιστρέφει 429 quota_exceeded.
Το σώμα του αιτήματος JSON δεν πρέπει να υπερβαίνει τα 64 KB. Στην πράξη, ένα URL είναι πολύ κάτω από αυτό το όριο.
import requests
API_KEY = "ip_live_xxxxxxxxxxxxxxxx"
BASE = "https://secure.instantproof.legal"
# Create a certificate
resp = requests.post(
f"{BASE}/api/v1/certificates",
json={"url": "https://example.com"},
headers={"Authorization": f"Bearer {API_KEY}"},
)
resp.raise_for_status()
data = resp.json()
recording_id = data["recordingId"]
# Download the PDF
pdf = requests.get(
f"{BASE}/api/v1/certificates/{recording_id}/download",
headers={"Authorization": f"Bearer {API_KEY}"},
allow_redirects=True,
)
pdf.raise_for_status()
with open("certificate.pdf", "wb") as f:
f.write(pdf.content)
print(f"Certificate saved ({len(pdf.content)} bytes)")
const API_KEY = process.env.INSTANTPROOF_API_KEY;
const BASE = "https://secure.instantproof.legal";
// Create a certificate
const res = await fetch(`${BASE}/api/v1/certificates`, {
method: "POST",
headers: {
"Authorization": `Bearer ${API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({ url: "https://example.com" }),
});
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const { recordingId, links } = await res.json();
// Download the PDF
const pdf = await fetch(`${BASE}${links.certificate}`, {
headers: { "Authorization": `Bearer ${API_KEY}` },
redirect: "follow",
});
const buffer = Buffer.from(await pdf.arrayBuffer());
require("fs").writeFileSync("certificate.pdf", buffer);
# Set your key
export INSTANTPROOF_API_KEY="ip_live_xxxxxxxxxxxxxxxx"
# Create
CERT=$(curl -sf -X POST https://secure.instantproof.legal/api/v1/certificates \
-H "Authorization: Bearer $INSTANTPROOF_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://example.com"}')
echo "$CERT" | python3 -m json.tool
RECORDING_ID=$(echo "$CERT" | python3 -c "import sys,json; print(json.load(sys.stdin)['recordingId'])")
# Download
curl -sfL \
-H "Authorization: Bearer $INSTANTPROOF_API_KEY" \
"https://secure.instantproof.legal/api/v1/certificates/$RECORDING_ID/download" \
-o certificate.pdf
ls -lh certificate.pdf
Συνήθως 10–60 δευτερόλεπτα, ανάλογα με τον χρόνο φόρτωσης της σελίδας-στόχου. Το αίτημα POST μένει σε αναμονή μέχρι να είναι έτοιμο το πιστοποιητικό — δεν υπάρχει βήμα επαναλαμβανόμενου ελέγχου (polling).
Το τρέχον API υποστηρίζει μόνο πιστοποίηση ιστότοπων (URL). Οι μεταφορτώσεις αρχείων είναι διαθέσιμες μέσω της διεπαφής ιστού στο secure.instantproof.legal/certificates/new.
Ναι. Το PDF που παράγεται από το API είναι πανομοιότυπο με εκείνο που δημιουργείται μέσω της διεπαφής ιστού. Σύρετέ το στο instantproof.legal/certificate.html για να επαληθεύσετε την υπογραφή Ed25519 και την αλυσίδα χρονοσφραγίδας RFC 3161.
Η υπηρεσία λήψης επιστρέφει σφάλμα 502 capture_failed. Η ημερήσια ποσόστωσή σας δεν καταναλώνεται.
Ναι. Κάθε πιστοποιητικό που δημιουργείται μέσω του API εμφανίζεται στον πίνακα Πιστοποιητικά, στην ενότητα Τα πιστοποιητικά ιστότοπών μου, μαζί με τα πιστοποιητικά που δημιουργούνται μέσω της διεπαφής ιστού.