Udvikler · REST API

Automatisér certificering af digitalt indhold via API'et

Sikr det · Forsegl det · Verificér det

InstantProof REST API'et lader dig certificere enhver offentlig URL programmatisk. Godkend med en Bearer API-nøgle, send en URL med POST, og modtag et signeret certifikat som PDF med en komplet bevispakke — med det samme RFC 3161-tidsstempel og den samme Ed25519-signatur som i webgrænsefladen.

Prøv det nu, ingen konto nødvendig.Dit første bevis er gratis · 10 € i velkomstkredit, når du bekræfter din e-mail · Intet kort nødvendigtLanceringstilbud. Kreditten kan også bruges til websidesikringer eller filcertificering.
RESTJSON over HTTPS
BearerGodkendelse med API-nøgle
RFC 3161Kvalificerede tidsstempler
Illustration af API-certificering
  1. 01

    Sikr det

    Gem en webside, optag en browsersession, eller certificér en fil.

  2. 02

    Forsegl det

    Et kryptografisk segl og tidsstempel hjælper med at afsløre senere ændringer.

  3. 03

    Verificér det

    Alle kan kontrollere bevispakken uafhængigt.

Digitale beviser. Gjort enkelt.

Sikr det, der er vigtigt. Før det ændrer sig.

Start med 10 € i velkomstkredit. Behold en kryptografisk forseglet bevispakke, som du kan downloade og verificere.

Sikr dit første bevis →

Forudsætninger

1
Pro-abonnement eller højereAPI'et kræver Pro -abonnementet (funktionen api_access). Tegn abonnement her.
2
En API-nøgleOpret en under Indstillinger → API-nøgler. Kopiér nøglen med det samme — den vises kun én gang.
3
En https://-URL, der skal certificeresAPI'et certificerer offentligt tilgængelige websider. URL'en skal være en gyldig https://-adresse.

Kom hurtigt i gang

Tre trin fra start til et signeret certifikat som PDF.

Trin 1 — Opret en API-nøgle

Log ind, gå til Udvikler → API-nøgler, og klik på Opret API-nøgle. Kopiér nøglen — den vises kun én gang.

Trin 2 — Opret et certifikat

Send en POST-anmodning med din 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"}'

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

Trin 3 — Download certifikatet som PDF

Følg URL'en i links.certificate med din API-nøgle. Serveren returnerer en 302-omdirigering til en forhåndssigneret download-URL:

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

Den downloadede PDF er det samme signerede certifikat som PDF, som webgrænsefladen producerer, og kan kontrolleres på /certificate.html.

API-reference

Basis-URL: https://secure.instantproof.legal
Alle endpoints returnerer JSON. Godkendelse: Authorization: Bearer <key>.

POST /api/v1/certificates

Opret et nyt websitecertifikat. Platformen optager URL'en i en headless browser, producerer en HAR-netværkslog og et skærmbillede, signerer manifestet med Ed25519 og forankrer det i et kvalificeret RFC 3161-tidsstempel. Handlingen tager 10–60 sekunder.

Anmodningens indhold (JSON)

FeltTypeBeskrivelse
urlstringpåkrævetEn gyldig https://-URL, der skal certificeres. Skal være offentligt tilgængelig.

Svar 201 Created

FeltTypeBeskrivelse
certificateIdstringLæsevenligt certifikat-ID (vises på PDF'en).
recordingIdstringIntern UUID for optagelsen. Bruges i efterfølgende API-kald.
urlstringDen URL, du indsendte.
finalUrlstringURL'en efter eventuelle omdirigeringer, som browseren så den.
statusstring"ready" — certifikatet er straks tilgængeligt.
links.selfstringSti til at hente certifikatets metadata.
links.certificatestringSti til at downloade PDF'en. Kræver godkendelse.

Fejlsvar

StatusfejlBetydning
400invalid_urlFeltet url mangler eller er ikke en gyldig https://-adresse.
400invalid_jsonAnmodningens indhold er ikke gyldig JSON.
401invalid_api_keyManglende eller ugyldig Authorization-header.
402api_access_requiredDin konto har ikke Pro-abonnementet. Tegn abonnement.
403subscription_requiredWebcertifikater kræver et abonnement med fast pris.
403insufficient_scopeAPI-nøglen mangler scopet certificates:write.
413payload_too_largeAnmodningens indhold overstiger 64 KB.
429quota_exceededDen daglige API-kvote for optagelser er nået. Nulstilles hver dag.
429rate_limitedFor mange anmodninger. Se headeren Retry-After.
429service_busyOptagetjenesten er ved kapacitetsgrænsen. Prøv igen om ca. 30 sekunder.
502capture_failedBrowseren kunne ikke indlæse URL'en.
502certification_failedOptagelsen gav intet brugbart bevis (f.eks. tom HAR).

GET /api/v1/certificates/:recordingId

Hent metadata for et certifikat, du tidligere har oprettet.

Stiparametre

ParameterBeskrivelse
recordingIdpåkrævetrecordingId returneret af POST /api/v1/certificates.

Svar 200 OK

FeltTypeBeskrivelse
certificateIdstringLæsevenligt certifikat-ID.
recordingIdstringIntern UUID for optagelsen.
typestringOptagelsestype (f.eks. "webcapture").
statusstring"ready", når certifikatet er tilgængeligt.
urlstringDen URL, der blev certificeret.
createdAtstringOprettelsestidspunkt i ISO 8601.
linksobjectStierne self og certificate.

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

Download det signerede certifikat som PDF. Returnerer 302 Found — følg omdirigeringen for at modtage filen. Brug curl -L eller requests.get(..., allow_redirects=True).

Godkendelse

Alle API-anmodninger skal indeholde:

Authorization: Bearer ip_live_xxxxxxxxxxxxxxxx

Nøgler oprettes under Indstillinger → Udvikler → API-nøgler. En nøgle godkender som din konto — behandl den som en adgangskode. Tilbagekald den straks, hvis den kommer ud.

Nøgler har præfikset ip_live_ for live-konti. Præfikset gør det nemt at genkende dem i kode eller miljøfiler.

Satsgrænser & kvoter

~30

Anmodninger pr. minut

30 anmodninger/minut vedvarende (burst: 30). Overskridelse giver 429 rate_limited med en Retry-After-header.

Dagligt

Daglig optagekvote

Pro-abonnementet giver et fast antal certifikatoprettelser pr. dag. Kvoten nulstilles hver dag. Overskridelse giver 429 quota_exceeded.

64 KB

Grænse for anmodningens indhold

JSON-indholdet i anmodningen må ikke overstige 64 KB. I praksis ligger en URL langt under grænsen.

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 stillede spørgsmål

Hvor lang tid tager det at oprette et certifikat?

Typisk 10–60 sekunder, afhængigt af målsidens indlæsningstid. POST-anmodningen blokerer, indtil certifikatet er klar — der er intet polling-trin.

Understøtter API'et filcertifikater (PDF, billedupload)?

Det nuværende API understøtter kun certificering af websites (URL). Filupload er tilgængelig via webgrænsefladen på secure.instantproof.legal/certificates/new.

Kan jeg kontrollere et certifikat, der er oprettet via API'et?

Ja. PDF'en fra API'et er identisk med en, der er oprettet via webgrænsefladen. Træk den over på instantproof.legal/certificate.html for at kontrollere Ed25519-signaturen og RFC 3161-tidsstempelkæden.

Hvad sker der, hvis URL'en ikke kan nås?

Optagetjenesten returnerer fejlen 502 capture_failed. Din daglige kvote bliver ikke brugt.

Kan certifikater oprettet via API'et ses i webdashboardet?

Ja. Hvert certifikat, der er oprettet via API'et, vises i dit certifikatdashboard under Mine websitecertifikater sammen med eventuelle certifikater fra webgrænsefladen.