Προγραμματιστές · REST API

Αυτοματοποιήστε την πιστοποίηση ψηφιακού περιεχομένου μέσω του API

Καταγράψτε το · Σφραγίστε το · Επαληθεύστε το

Το REST API του InstantProof σάς επιτρέπει να πιστοποιείτε οποιοδήποτε δημόσιο URL προγραμματιστικά. Ταυτοποιηθείτε με κλειδί API τύπου Bearer, στείλτε με POST ένα URL και λάβετε υπογεγραμμένο πιστοποιητικό PDF με πλήρες πακέτο αποδεικτικών — με την ίδια χρονοσφραγίδα RFC 3161 και υπογραφή Ed25519 όπως στη διεπαφή ιστού.

Δοκιμάστε το τώρα, χωρίς λογαριασμό.Η πρώτη σας απόδειξη είναι δωρεάν · πίστωση καλωσορίσματος €10 όταν επιβεβαιώσετε το email σας · Χωρίς κάρταΠροσφορά εκκίνησης. Η πίστωση μπορεί να χρησιμοποιηθεί και για λήψεις ιστοσελίδων ή πιστοποίηση αρχείων.
RESTJSON μέσω HTTPS
BearerΤαυτοποίηση με κλειδί API
RFC 3161Εγκεκριμένες χρονοσφραγίδες
Εικονογράφηση πιστοποίησης μέσω API
  1. 01

    Καταγράψτε το

    Αποθηκεύστε μια ιστοσελίδα, καταγράψτε μια συνεδρία προγράμματος περιήγησης ή πιστοποιήστε ένα αρχείο.

  2. 02

    Σφραγίστε το

    Μια κρυπτογραφική σφραγίδα και χρονοσήμανση βοηθούν να αποκαλυφθούν μεταγενέστερες αλλαγές.

  3. 03

    Επαληθεύστε το

    Οποιοσδήποτε μπορεί να ελέγξει ανεξάρτητα το πακέτο αποδεικτικών.

Ψηφιακά αποδεικτικά στοιχεία. Απλά.

Καταγράψτε ό,τι μετράει. Πριν αλλάξει.

Ξεκινήστε με πίστωση καλωσορίσματος €10. Αποκτήστε ένα κρυπτογραφικά σφραγισμένο πακέτο αποδεικτικών που μπορείτε να κατεβάσετε και να επαληθεύσετε.

Καταγράψτε την πρώτη σας απόδειξη →

Προαπαιτούμενα

1
Πακέτο Pro ή ανώτεροΤο API απαιτεί τη συνδρομή Pro (λειτουργία api_access). Εγγραφείτε εδώ.
2
Ένα κλειδί APIΔημιουργήστε ένα στο Ρυθμίσεις → Κλειδιά API. Αντιγράψτε αμέσως το κλειδί — εμφανίζεται μόνο μία φορά.
3
Ένα URL https:// προς πιστοποίησηΤο API πιστοποιεί δημόσια προσβάσιμες ιστοσελίδες. Το URL πρέπει να είναι έγκυρη διεύθυνση https://.

Γρήγορη εκκίνηση

Τρία βήματα από το μηδέν έως ένα υπογεγραμμένο πιστοποιητικό PDF.

Βήμα 1 — Δημιουργήστε ένα κλειδί API

Συνδεθείτε, μεταβείτε στο Προγραμματιστές → Κλειδιά API και πατήστε Δημιουργία κλειδιού API. Αντιγράψτε το κλειδί — εμφανίζεται μόνο μία φορά.

Βήμα 2 — Δημιουργήστε ένα πιστοποιητικό

Στείλτε ένα αίτημα 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"
  }
}

Βήμα 3 — Κατεβάστε το πιστοποιητικό PDF

Ακολουθήστε το 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.

Τεκμηρίωση API

Βασικό URL: https://secure.instantproof.legal
Όλα τα endpoints επιστρέφουν JSON. Ταυτοποίηση: Authorization: Bearer <key>.

POST /api/v1/certificates

Δημιουργεί ένα νέο πιστοποιητικό ιστότοπου. Η πλατφόρμα αποτυπώνει το URL σε πρόγραμμα περιήγησης χωρίς γραφική διεπαφή, παράγει αρχείο καταγραφής δικτύου HAR και στιγμιότυπο οθόνης, υπογράφει το μανιφέστο με Ed25519 και το αγκιστρώνει σε εγκεκριμένη χρονοσφραγίδα RFC 3161. Η λειτουργία διαρκεί 10–60 δευτερόλεπτα.

Σώμα αιτήματος (JSON)

ΠεδίοΤύποςΠεριγραφή
urlstringυποχρεωτικόΈνα έγκυρο URL https:// προς πιστοποίηση. Πρέπει να είναι δημόσια προσβάσιμο.

Απάντηση 201 Created

ΠεδίοΤύποςΠεριγραφή
certificateIdstringΑναγνώσιμο από τον άνθρωπο αναγνωριστικό πιστοποιητικού (εμφανίζεται στο PDF).
recordingIdstringΕσωτερικό UUID της καταγραφής. Χρησιμοποιήστε το σε επόμενες κλήσεις API.
urlstringΤο URL που υποβάλατε.
finalUrlstringΤο URL μετά από τυχόν ανακατευθύνσεις, όπως το είδε το πρόγραμμα περιήγησης.
statusstring"ready" — το πιστοποιητικό είναι άμεσα διαθέσιμο.
links.selfstringΔιαδρομή για την ανάκτηση των μεταδεδομένων αυτού του πιστοποιητικού.
links.certificatestringΔιαδρομή για τη λήψη του PDF. Απαιτεί ταυτοποίηση.

Απαντήσεις σφάλματος

ΚατάστασησφάλμαΣημασία
400invalid_urlΤο πεδίο url λείπει ή δεν είναι έγκυρη διεύθυνση https://.
400invalid_jsonΤο σώμα του αιτήματος δεν είναι έγκυρο JSON.
401invalid_api_keyΛείπει η κεφαλίδα Authorization ή δεν είναι έγκυρη.
402api_access_requiredΟ λογαριασμός σας δεν διαθέτει το πακέτο Pro. Εγγραφείτε.
403subscription_requiredΤα πιστοποιητικά ιστού απαιτούν συνδρομή πάγιας χρέωσης.
403insufficient_scopeΤο κλειδί API δεν διαθέτει το εύρος certificates:write.
413payload_too_largeΤο σώμα του αιτήματος υπερβαίνει τα 64 KB.
429quota_exceededΣυμπληρώθηκε η ημερήσια ποσόστωση λήψεων API. Επαναφέρεται κάθε ημέρα.
429rate_limitedΠάρα πολλά αιτήματα. Δείτε την κεφαλίδα Retry-After.
429service_busyΗ υπηρεσία λήψης λειτουργεί στο όριο της χωρητικότητάς της. Δοκιμάστε ξανά μετά από ~30 δευτερόλεπτα.
502capture_failedΤο πρόγραμμα περιήγησης δεν μπόρεσε να φορτώσει το URL.
502certification_failedΗ λήψη δεν παρήγαγε αξιοποιήσιμα αποδεικτικά στοιχεία (π.χ. κενό HAR).

GET /api/v1/certificates/:recordingId

Ανακτά τα μεταδεδομένα ενός πιστοποιητικού που δημιουργήσατε προηγουμένως.

Παράμετροι διαδρομής

ΠαράμετροςΠεριγραφή
recordingIdυποχρεωτικόΤο recordingId που επιστρέφεται από το POST /api/v1/certificates.

Απάντηση 200 OK

ΠεδίοΤύποςΠεριγραφή
certificateIdstringΑναγνώσιμο από τον άνθρωπο αναγνωριστικό πιστοποιητικού.
recordingIdstringΕσωτερικό UUID της καταγραφής.
typestringΤύπος καταγραφής (π.χ. "webcapture").
statusstring"ready" μόλις το πιστοποιητικό είναι διαθέσιμο.
urlstringΤο URL που πιστοποιήθηκε.
createdAtstringΧρονοσφραγίδα δημιουργίας ISO 8601.
linksobjectΔιαδρομές self και certificate.

GET /api/v1/certificates/:recordingId/download

Κατεβάζει το υπογεγραμμένο πιστοποιητικό PDF. Επιστρέφει 302 Found — ακολουθήστε την ανακατεύθυνση για να λάβετε το αρχείο. Χρησιμοποιήστε curl -L ή requests.get(..., allow_redirects=True).

Ταυτοποίηση

Όλα τα αιτήματα API πρέπει να περιλαμβάνουν:

Authorization: Bearer ip_live_xxxxxxxxxxxxxxxx

Τα κλειδιά δημιουργούνται στο Ρυθμίσεις → Προγραμματιστές → Κλειδιά API. Ένα κλειδί ταυτοποιεί τον λογαριασμό σας — αντιμετωπίστε το σαν κωδικό πρόσβασης. Ανακαλέστε το αμέσως εάν διαρρεύσει.

Τα κλειδιά έχουν το πρόθεμα ip_live_ για ενεργούς λογαριασμούς. Το πρόθεμα σάς βοηθά να τα εντοπίζετε στον κώδικα ή σε αρχεία περιβάλλοντος.

Όρια ρυθμού & ποσοστώσεις

~30

Αιτήματα ανά λεπτό

30 αιτήματα/λεπτό σε συνεχή βάση (ριπή: 30). Η υπέρβαση επιστρέφει 429 rate_limited με κεφαλίδα Retry-After.

Ημερήσιο

Ημερήσια ποσόστωση λήψεων

Το πακέτο Pro παρέχει σταθερό αριθμό δημιουργιών πιστοποιητικών ανά ημέρα. Η ποσόστωση επαναφέρεται κάθε ημέρα. Η υπέρβασή της επιστρέφει 429 quota_exceeded.

64 KB

Όριο σώματος αιτήματος

Το σώμα του αιτήματος JSON δεν πρέπει να υπερβαίνει τα 64 KB. Στην πράξη, ένα URL είναι πολύ κάτω από αυτό το όριο.

Παραδείγματα κώδικα

Python

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)")

Node.js (fetch)

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);

Shell (curl)

# 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 πιστοποιητικά αρχείων (PDF, μεταφορτώσεις εικόνων);

Το τρέχον API υποστηρίζει μόνο πιστοποίηση ιστότοπων (URL). Οι μεταφορτώσεις αρχείων είναι διαθέσιμες μέσω της διεπαφής ιστού στο secure.instantproof.legal/certificates/new.

Μπορώ να επαληθεύσω ένα πιστοποιητικό που δημιουργήθηκε μέσω του API;

Ναι. Το PDF που παράγεται από το API είναι πανομοιότυπο με εκείνο που δημιουργείται μέσω της διεπαφής ιστού. Σύρετέ το στο instantproof.legal/certificate.html για να επαληθεύσετε την υπογραφή Ed25519 και την αλυσίδα χρονοσφραγίδας RFC 3161.

Τι συμβαίνει αν το URL δεν είναι προσβάσιμο;

Η υπηρεσία λήψης επιστρέφει σφάλμα 502 capture_failed. Η ημερήσια ποσόστωσή σας δεν καταναλώνεται.

Είναι ορατά στον πίνακα ελέγχου ιστού τα πιστοποιητικά που δημιουργούνται μέσω API;

Ναι. Κάθε πιστοποιητικό που δημιουργείται μέσω του API εμφανίζεται στον πίνακα Πιστοποιητικά, στην ενότητα Τα πιστοποιητικά ιστότοπών μου, μαζί με τα πιστοποιητικά που δημιουργούνται μέσω της διεπαφής ιστού.