Developer · REST API

Digitale inhoudscertificering automatiseren via de API

Leg het vast · Verzegel het · Verifieer het

De InstantProof REST API stelt u in staat elke openbare URL programmatisch te certificeren. Authenticeer met een Bearer API-sleutel, POST een URL en ontvang een ondertekend pdf-certificaat met een volledige bewijsbundel — dezelfde RFC 3161-tijdstempel en Ed25519-handtekening als de webinterface.

Probeer het nu, zonder account.Uw eerste bewijs is gratis · €10 welkomstkrediet zodra u uw e-mail bevestigt · Geen kaart nodigLanceeraanbod. Ook bruikbaar voor webpaginacaptures of bestandscertificering.
RESTJSON over HTTPS
BearerAPI-sleutelauthenticatie
RFC 3161Gekwalificeerde tijdstempels
Illustratie API-certificering
  1. 01

    Leg het vast

    Bewaar een webpagina, neem een browsersessie op of certificeer een bestand.

  2. 02

    Verzegel het

    Een cryptografisch zegel en tijdstempel helpen latere wijzigingen aantonen.

  3. 03

    Verifieer het

    Iedereen kan het bewijspakket onafhankelijk controleren.

Vereisten

1
Pro-abonnement of hogerDe API vereist het Pro-abonnement (api_access-functie). Abonneer hier.
2
Een API-sleutelMaak een aan via Instellingen → API-sleutels. Kopieer de sleutel direct — hij wordt slechts eenmaal getoond.
3
Een https://-URL om te certificerenDe API certificeert openbaar bereikbare webpagina's. De URL moet een geldig https://-adres zijn.

Snelstart

In drie stappen van nul naar een ondertekend pdf-certificaat.

Stap 1 — Maak een API-sleutel aan

Log in, ga naar Developer → API-sleutels en klik op API-sleutel aanmaken. Kopieer de sleutel — hij wordt slechts eenmaal getoond.

Stap 2 — Maak een certificaat aan

Stuur een POST-verzoek met uw 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://voorbeeld.com/te-certificeren-pagina"}'

Respons 201 Created:

{
  "certificateId": "abc123…",
  "recordingId":   "def456…",
  "url":           "https://voorbeeld.com/te-certificeren-pagina",
  "finalUrl":      "https://voorbeeld.com/te-certificeren-pagina",
  "status":        "ready",
  "links": {
    "self":        "/api/v1/certificates/def456…",
    "certificate": "/api/v1/certificates/def456…/download"
  }
}

Stap 3 — Download het pdf-certificaat

Volg de links.certificate-URL met uw API-sleutel. De server stuurt een 302-redirect naar een vooraf ondertekende download-URL:

curl -L \
  -H "Authorization: Bearer ip_live_xxxxxxxxxxxxxxxx" \
  "https://secure.instantproof.legal/api/v1/certificates/def456…/download" \
  -o certificaat.pdf

Het gedownloade PDF is hetzelfde ondertekende certificaat-PDF als de webinterface produceert, verifieerbaar op /certificate.html.

API-referentie

Basis-URL: https://secure.instantproof.legal
Alle endpoints retourneren JSON. Authenticatie: Authorization: Bearer <sleutel>.

POST /api/v1/certificates

Maak een nieuw websitecertificaat aan. Het platform legt de URL vast in een headless browser, produceert een HAR-netwerklog en schermafbeelding, ondertekent het manifest met Ed25519 en verankert aan een gekwalificeerde RFC 3161-tijdstempel. De operatie duurt 10–60 seconden.

Verzoekbody (JSON)

VeldTypeBeschrijving
urlstringverplichtEen geldige https://-URL om te certificeren. Moet openbaar bereikbaar zijn.

Respons 201 Created

VeldTypeBeschrijving
certificateIdstringLeesbare certificaat-ID (weergegeven op het PDF).
recordingIdstringInterne opname-UUID. Gebruik in volgende API-aanroepen.
urlstringDe door u ingediende URL.
finalUrlstringDe URL na eventuele omleidingen, zoals gezien door de browser.
statusstring"ready" — het certificaat is direct beschikbaar.
links.selfstringPad om metagegevens van dit certificaat op te halen.
links.certificatestringPad om het PDF te downloaden. Vereist authenticatie.

Foutresponsen

StatuserrorBetekenis
400invalid_urlHet url-veld ontbreekt of is geen geldig https://-adres.
400invalid_jsonVerzoekbody is geen geldige JSON.
401invalid_api_keyOntbrekende of ongeldige Authorization-header.
402api_access_requiredUw account heeft geen Pro-abonnement. Abonneer.
403subscription_requiredWebcertificaten vereisen een flat-rate abonnement.
429quota_exceededDagelijks API-quotum bereikt. Reset elke dag.
429rate_limitedTe veel verzoeken. Zie Retry-After-header.
502capture_failedDe browser kon de URL niet laden.

GET /api/v1/certificates/:recordingId

Haal metagegevens op voor een eerder aangemaakt certificaat.


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

Download het ondertekende pdf-certificaat. Retourneert 302 Found — volg de omleiding om het bestand te ontvangen. Gebruik curl -L of requests.get(..., allow_redirects=True).

Veelgestelde vragen

Hoe lang duurt het aanmaken van een certificaat?

Doorgaans 10–60 seconden, afhankelijk van de laadtijd van de doelpagina. Het POST-verzoek blokkeert totdat het certificaat gereed is — er is geen polling-stap.

Worden bestandscertificaten (PDF, afbeeldingen) ondersteund?

De huidige API ondersteunt alleen websitecertificering. Bestandsuploads zijn beschikbaar via de webinterface op secure.instantproof.legal/certificates/new.

Kan ik een via de API aangemaakt certificaat verifiëren?

Ja. Het PDF van de API is identiek aan dat van de webinterface. Sleep het naar instantproof.legal/nl/certificate.html om de Ed25519-handtekening en RFC 3161-keten te verifiëren.