Forespørsler per minutt
30 forespørsler/minutt vedvarende (burst: 30). Overskrides grensen, returneres 429 rate_limited med en Retry-After-header.
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.
Lagre en nettside, ta opp en nettleserøkt eller sertifiser en fil.
Et kryptografisk segl og tidsstempel bidrar til å avdekke senere endringer.
Alle kan kontrollere bevispakken uavhengig.
Start med 10 € i velkomstkreditt. Behold en kryptografisk forseglet bevispakke som du kan laste ned og verifisere.
Tre trinn fra ingenting til et signert sertifikat i PDF.
Logg inn, gå til Utvikler → API-nøkler og klikk på Opprett API-nøkkel. Kopier nøkkelen – den vises bare én gang.
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"
}
}
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.
Base-URL: https://secure.instantproof.legal
Alle endepunkter returnerer JSON. Autentisering: Authorization: Bearer <key>.
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.
| Felt | Type | Beskrivelse | |
|---|---|---|---|
url | string | påkrevd | En gyldig https://-URL som skal sertifiseres. Må være offentlig tilgjengelig. |
| Felt | Type | Beskrivelse |
|---|---|---|
certificateId | string | Lesbar sertifikat-ID (vises på PDF-en). |
recordingId | string | Intern UUID for opptaket. Brukes i senere API-kall. |
url | string | URL-en du sendte inn. |
finalUrl | string | URL-en etter eventuelle omdirigeringer, slik nettleseren så den. |
status | string | "ready" – sertifikatet er umiddelbart tilgjengelig. |
links.self | string | Sti for å hente metadataene til dette sertifikatet. |
links.certificate | string | Sti for å laste ned PDF-en. Krever autentisering. |
| Status | feil | Betydning |
|---|---|---|
| 400 | invalid_url | Feltet url mangler eller er ikke en gyldig https://-adresse. |
| 400 | invalid_json | Forespørselens innhold er ikke gyldig JSON. |
| 401 | invalid_api_key | Manglende eller ugyldig Authorization-header. |
| 402 | api_access_required | Kontoen din har ikke Pro-abonnement. Abonner. |
| 403 | subscription_required | Nettsertifikater krever et abonnement med fast pris. |
| 403 | insufficient_scope | API-nøkkelen mangler scopet certificates:write. |
| 413 | payload_too_large | Forespørselens innhold overstiger 64 KB. |
| 429 | quota_exceeded | Daglig API-kvote for sikring er nådd. Nullstilles hver dag. |
| 429 | rate_limited | For mange forespørsler. Se Retry-After-headeren. |
| 429 | service_busy | Sikringstjenesten er fullt belastet. Prøv igjen etter ca. 30 sekunder. |
| 502 | capture_failed | Nettleseren kunne ikke laste URL-en. |
| 502 | certification_failed | Sikringen ga ikke noe brukbart bevis (f.eks. tom HAR). |
Hent metadata for et sertifikat du har laget tidligere.
| Parameter | Beskrivelse | |
|---|---|---|
recordingId | påkrevd | recordingId som POST /api/v1/certificates returnerte. |
| Felt | Type | Beskrivelse |
|---|---|---|
certificateId | string | Lesbar sertifikat-ID. |
recordingId | string | Intern UUID for opptaket. |
type | string | Opptakstype (f.eks. "webcapture"). |
status | string | "ready" når sertifikatet er tilgjengelig. |
url | string | URL-en som ble sertifisert. |
createdAt | string | Tidsstempel for opprettelsen i ISO 8601. |
links | object | Stiene self og certificate. |
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).
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.
30 forespørsler/minutt vedvarende (burst: 30). Overskrides grensen, returneres 429 rate_limited med en Retry-After-header.
Pro-abonnementet gir et fast antall sertifikater per dag. Kvoten nullstilles hver dag. Overskrides den, returneres 429 quota_exceeded.
JSON-innholdet i forespørselen må ikke overstige 64 KB. I praksis er en URL langt under denne grensen.
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)")
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);
# 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
Vanligvis 10–60 sekunder, avhengig av hvor raskt målsiden lastes. POST-forespørselen blokkerer til sertifikatet er klart – det finnes ikke noe pollingtrinn.
Det nåværende API-et støtter bare sertifisering av nettsteder (URL). Filopplasting er tilgjengelig i nettgrensesnittet på secure.instantproof.legal/certificates/new.
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.
Sikringstjenesten returnerer feilen 502 capture_failed. Den daglige kvoten din brukes ikke opp.
Ja. Hvert sertifikat som lages via API-et, vises i sertifikatdashbordet under Mine nettstedsertifikater, sammen med sertifikater fra nettgrensesnittet.