Utvikler · REST API

Automatiser sertifisering av digitalt innhold via API-et

Sikre det · Forsegl det · Verifiser det

Med InstantProof REST API kan du sertifisere en hvilken som helst offentlig URL programmatisk. Autentiser deg med en Bearer API-nøkkel, send en URL med POST og få et signert sertifikat i PDF med en fullstendig bevispakke – samme RFC 3161-tidsstempel og Ed25519-signatur som i nettgrensesnittet.

Prøv nå, uten konto.Ditt første bevis er gratis · 10 € i velkomstkreditt når du bekrefter e-posten · Du trenger ikke kortLanseringstilbud. Kreditten kan også brukes til nettsidesikringer eller filsertifisering.
RESTJSON over HTTPS
BearerAutentisering med API-nøkkel
RFC 3161Kvalifiserte tidsstempler
Illustrasjon av API-sertifisering
  1. 01

    Sikre det

    Lagre en nettside, ta opp en nettleserøkt eller sertifiser en fil.

  2. 02

    Forsegl det

    Et kryptografisk segl og tidsstempel bidrar til å avdekke senere endringer.

  3. 03

    Verifiser det

    Alle kan kontrollere bevispakken uavhengig.

Digitale bevis. Gjort enkelt.

Sikre det som betyr noe. Før det endrer seg.

Start med 10 € i velkomstkreditt. Behold en kryptografisk forseglet bevispakke som du kan laste ned og verifisere.

Sikre ditt første bevis →

Forutsetninger

1
Pro-abonnement eller høyereAPI-et krever Pro -abonnementet (funksjonen api_access). Abonner her.
2
En API-nøkkelOpprett en under Innstillinger → API-nøkler. Kopier nøkkelen med en gang – den vises bare én gang.
3
En https://-URL som skal sertifiseresAPI-et sertifiserer offentlig tilgjengelige nettsider. URL-en må være en gyldig https://-adresse.

Hurtigstart

Tre trinn fra ingenting til et signert sertifikat i PDF.

Trinn 1 – Opprett en API-nøkkel

Logg inn, gå til Utvikler → API-nøkler og klikk på Opprett API-nøkkel. Kopier nøkkelen – den vises bare én gang.

Trinn 2 – Lag et sertifikat

Send en POST-forespørsel med URL-en din:

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"}'

Svar 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"
  }
}

Trinn 3 – Last ned sertifikatet i PDF

Følg URL-en i links.certificate med API-nøkkelen din. Serveren returnerer en 302-omdirigering til en forhåndssignert nedlastings-URL:

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

Den nedlastede PDF-en er det samme signerte sertifikatet i PDF som nettgrensesnittet lager, og kan verifiseres på /certificate.html.

API-referanse

Base-URL: https://secure.instantproof.legal
Alle endepunkter returnerer JSON. Autentisering: Authorization: Bearer <key>.

POST /api/v1/certificates

Lag et nytt nettstedsertifikat. Plattformen sikrer URL-en i en hodeløs nettleser, lager en HAR-nettverkslogg og et skjermbilde, signerer manifestet med Ed25519 og forankrer det i et kvalifisert RFC 3161-tidsstempel. Operasjonen tar 10–60 sekunder.

Forespørselens innhold (JSON)

FeltTypeBeskrivelse
urlstringpåkrevdEn gyldig https://-URL som skal sertifiseres. Må være offentlig tilgjengelig.

Svar 201 Created

FeltTypeBeskrivelse
certificateIdstringLesbar sertifikat-ID (vises på PDF-en).
recordingIdstringIntern UUID for opptaket. Brukes i senere API-kall.
urlstringURL-en du sendte inn.
finalUrlstringURL-en etter eventuelle omdirigeringer, slik nettleseren så den.
statusstring"ready" – sertifikatet er umiddelbart tilgjengelig.
links.selfstringSti for å hente metadataene til dette sertifikatet.
links.certificatestringSti for å laste ned PDF-en. Krever autentisering.

Feilsvar

StatusfeilBetydning
400invalid_urlFeltet url mangler eller er ikke en gyldig https://-adresse.
400invalid_jsonForespørselens innhold er ikke gyldig JSON.
401invalid_api_keyManglende eller ugyldig Authorization-header.
402api_access_requiredKontoen din har ikke Pro-abonnement. Abonner.
403subscription_requiredNettsertifikater krever et abonnement med fast pris.
403insufficient_scopeAPI-nøkkelen mangler scopet certificates:write.
413payload_too_largeForespørselens innhold overstiger 64 KB.
429quota_exceededDaglig API-kvote for sikring er nådd. Nullstilles hver dag.
429rate_limitedFor mange forespørsler. Se Retry-After-headeren.
429service_busySikringstjenesten er fullt belastet. Prøv igjen etter ca. 30 sekunder.
502capture_failedNettleseren kunne ikke laste URL-en.
502certification_failedSikringen ga ikke noe brukbart bevis (f.eks. tom HAR).

GET /api/v1/certificates/:recordingId

Hent metadata for et sertifikat du har laget tidligere.

Stiparametere

ParameterBeskrivelse
recordingIdpåkrevdrecordingId som POST /api/v1/certificates returnerte.

Svar 200 OK

FeltTypeBeskrivelse
certificateIdstringLesbar sertifikat-ID.
recordingIdstringIntern UUID for opptaket.
typestringOpptakstype (f.eks. "webcapture").
statusstring"ready" når sertifikatet er tilgjengelig.
urlstringURL-en som ble sertifisert.
createdAtstringTidsstempel for opprettelsen i ISO 8601.
linksobjectStiene self og certificate.

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

Last ned det signerte sertifikatet i PDF. Returnerer 302 Found – følg omdirigeringen for å få filen. Bruk curl -L eller requests.get(..., allow_redirects=True).

Autentisering

Alle API-forespørsler må inneholde:

Authorization: Bearer ip_live_xxxxxxxxxxxxxxxx

Nøkler opprettes under Innstillinger → Utvikler → API-nøkler. En nøkkel autentiserer som kontoen din – behandle den som et passord. Tilbakekall den umiddelbart hvis den lekker.

Nøkler har prefikset ip_live_ for live-kontoer. Prefikset hjelper deg å kjenne dem igjen i kode eller miljøfiler.

Rategrenser & kvoter

~30

Forespørsler per minutt

30 forespørsler/minutt vedvarende (burst: 30). Overskrides grensen, returneres 429 rate_limited med en Retry-After-header.

Daglig

Daglig kvote for sikring

Pro-abonnementet gir et fast antall sertifikater per dag. Kvoten nullstilles hver dag. Overskrides den, returneres 429 quota_exceeded.

64 KB

Grense for forespørselens innhold

JSON-innholdet i forespørselen må ikke overstige 64 KB. I praksis er en URL langt under denne grensen.

Kodeeksempler

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

Ofte stilte spørsmål

Hvor lang tid tar det å lage et sertifikat?

Vanligvis 10–60 sekunder, avhengig av hvor raskt målsiden lastes. POST-forespørselen blokkerer til sertifikatet er klart – det finnes ikke noe pollingtrinn.

Støtter API-et filsertifikater (PDF, bildeopplasting)?

Det nåværende API-et støtter bare sertifisering av nettsteder (URL). Filopplasting er tilgjengelig i nettgrensesnittet på secure.instantproof.legal/certificates/new.

Kan jeg verifisere et sertifikat som er laget via API-et?

Ja. PDF-en som API-et lager, er identisk med en som lages i nettgrensesnittet. Dra den til instantproof.legal/certificate.html for å verifisere Ed25519-signaturen og kjeden av RFC 3161-tidsstempler.

Hva skjer hvis URL-en ikke kan nås?

Sikringstjenesten returnerer feilen 502 capture_failed. Den daglige kvoten din brukes ikke opp.

Vises sertifikater laget via API-et i nettdashbordet?

Ja. Hvert sertifikat som lages via API-et, vises i sertifikatdashbordet under Mine nettstedsertifikater, sammen med sertifikater fra nettgrensesnittet.