Developer · REST API

Digitale inhoudscertificering automatiseren via de API

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.

API-sleutel aanvragen Vraag vroege toegang aan → Snelstart

RESTJSON over HTTPS

BearerAPI-sleutelauthenticatie

RFC 3161Gekwalificeerde tijdstempels

Vereisten

Pro-abonnement of hogerDe API vereist het Pro-abonnement (api_access-functie). Abonneer hier.

Een API-sleutelMaak een aan via Instellingen → API-sleutels. Kopieer de sleutel direct — hij wordt slechts eenmaal getoond.

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)

Veld	Type		Beschrijving
`url`	string	verplicht	Een geldige `https://`-URL om te certificeren. Moet openbaar bereikbaar zijn.

Respons 201 Created

Veld	Type	Beschrijving
`certificateId`	string	Leesbare certificaat-ID (weergegeven op het PDF).
`recordingId`	string	Interne opname-UUID. Gebruik in volgende API-aanroepen.
`url`	string	De door u ingediende URL.
`finalUrl`	string	De URL na eventuele omleidingen, zoals gezien door de browser.
`status`	string	`"ready"` — het certificaat is direct beschikbaar.
`links.self`	string	Pad om metagegevens van dit certificaat op te halen.
`links.certificate`	string	Pad om het PDF te downloaden. Vereist authenticatie.

Foutresponsen

Status	error	Betekenis
400	invalid_url	Het `url`-veld ontbreekt of is geen geldig https://-adres.
400	invalid_json	Verzoekbody is geen geldige JSON.
401	invalid_api_key	Ontbrekende of ongeldige `Authorization`-header.
402	api_access_required	Uw account heeft geen Pro-abonnement. Abonneer.
403	subscription_required	Webcertificaten vereisen een flat-rate abonnement.
429	quota_exceeded	Dagelijks API-quotum bereikt. Reset elke dag.
429	rate_limited	Te veel verzoeken. Zie `Retry-After`-header.
502	capture_failed	De 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.