Utvecklare · REST-API

Automatisera certifiering av digitalt innehåll via API:et

Fånga det · Försegla det · Verifiera det

Med InstantProofs REST-API kan du certifiera valfri offentlig URL via program. Autentisera med en Bearer-API-nyckel, skicka en URL med POST och få ett signerat certifikat i PDF med ett fullständigt bevispaket — samma RFC 3161-tidsstämpel och Ed25519-signatur som i webbgränssnittet.

Prova nu, inget konto behövs.Ditt första bevis är gratis · 10 € välkomstkredit när du bekräftar din e-postadress · Inget kort behövsLanseringserbjudande. Krediten kan också användas för webbsidefångster eller filcertifiering.
RESTJSON över HTTPS
BearerAutentisering med API-nyckel
RFC 3161Kvalificerade tidsstämplar
Illustration av API-certifiering
  1. 01

    Fånga det

    Spara en webbsida, spela in en webbläsarsession eller certifiera en fil.

  2. 02

    Försegla det

    Ett kryptografiskt sigill och en tidsstämpel gör att senare ändringar kan upptäckas.

  3. 03

    Verifiera det

    Vem som helst kan kontrollera bevispaketet oberoende.

Digitala bevis. Enkelt.

Fånga det som räknas. Innan det ändras.

Börja med 10 € i välkomstkredit. Behåll ett kryptografiskt förseglat bevispaket som du kan ladda ner och verifiera.

Fånga ditt första bevis →

Förutsättningar

1
Pro-abonnemang eller högreAPI:et kräver Pro -abonnemang (funktionen api_access). Teckna abonnemang här.
2
En API-nyckelSkapa en under Inställningar → API-nycklar. Kopiera nyckeln direkt — den visas bara en gång.
3
En https://-URL att certifieraAPI:et certifierar offentligt nåbara webbsidor. URL:en måste vara en giltig https://-adress.

Snabbstart

Tre steg från noll till ett signerat certifikat i PDF.

Steg 1 — Skapa en API-nyckel

Logga in, gå till Utvecklare → API-nycklar och klicka på Skapa API-nyckel. Kopiera nyckeln — den visas bara en gång.

Steg 2 — Skapa ett certifikat

Skicka en POST-förfrågan 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"
  }
}

Steg 3 — Ladda ner certifikatet i PDF

Följ URL:en i links.certificate med din API-nyckel. Servern returnerar en 302-omdirigering till en försignerad nedladdnings-URL:

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

Den nedladdade PDF-filen är samma signerade certifikat som webbgränssnittet skapar och kan verifieras på /certificate.html.

API-referens

Bas-URL: https://secure.instantproof.legal
Alla endpoints returnerar JSON. Autentisering: Authorization: Bearer <key>.

POST /api/v1/certificates

Skapa ett nytt webbplatscertifikat. Plattformen säkrar URL:en i en huvudlös webbläsare, skapar en HAR-nätverkslogg och en skärmbild, signerar manifestet med Ed25519 och förankrar det i en kvalificerad RFC 3161-tidsstämpel. Åtgärden tar 10–60 sekunder.

Request body (JSON)

FältTypBeskrivning
urlstringobligatorisktEn giltig https://-URL att certifiera. Måste vara offentligt nåbar.

Svar 201 Created

FältTypBeskrivning
certificateIdstringLäsbart certifikat-ID (visas på PDF-filen).
recordingIdstringInternt UUID för inspelningen. Används i efterföljande API-anrop.
urlstringURL:en du skickade in.
finalUrlstringURL:en efter eventuella omdirigeringar, som webbläsaren såg den.
statusstring"ready" — certifikatet är tillgängligt direkt.
links.selfstringSökväg för att hämta certifikatets metadata.
links.certificatestringSökväg för att ladda ner PDF-filen. Kräver autentisering.

Felsvar

StatuserrorBetydelse
400invalid_urlFältet url saknas eller är inte en giltig https://-adress.
400invalid_jsonRequest body är inte giltig JSON.
401invalid_api_keyRubriken Authorization saknas eller är ogiltig.
402api_access_requiredDitt konto har inte Pro-abonnemang. Teckna abonnemang.
403subscription_requiredWebbcertifikat kräver ett abonnemang med fast avgift.
403insufficient_scopeAPI-nyckeln saknar behörigheten certificates:write.
413payload_too_largeRequest body överstiger 64 KB.
429quota_exceededDagskvoten för API-säkringar är nådd. Nollställs varje dag.
429rate_limitedFör många förfrågningar. Se rubriken Retry-After.
429service_busySäkringstjänsten är fullbelagd. Försök igen efter ca 30 sekunder.
502capture_failedWebbläsaren kunde inte ladda URL:en.
502certification_failedSäkringen gav inget användbart bevis (t.ex. tom HAR).

GET /api/v1/certificates/:recordingId

Hämta metadata för ett certifikat som du tidigare skapat.

Sökvägsparametrar

ParameterBeskrivning
recordingIdobligatorisktrecordingId som returneras av POST /api/v1/certificates.

Svar 200 OK

FältTypBeskrivning
certificateIdstringLäsbart certifikat-ID.
recordingIdstringInternt UUID för inspelningen.
typestringInspelningstyp (t.ex. "webcapture").
statusstring"ready" när certifikatet är tillgängligt.
urlstringURL:en som certifierades.
createdAtstringTidsstämpel för skapandet enligt ISO 8601.
linksobjectSökvägarna self och certificate.

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

Ladda ner det signerade certifikatet i PDF. Returnerar 302 Found — följ omdirigeringen för att få filen. Använd curl -L eller requests.get(..., allow_redirects=True).

Autentisering

Alla API-förfrågningar måste innehålla:

Authorization: Bearer ip_live_xxxxxxxxxxxxxxxx

Nycklar skapas under Inställningar → Utvecklare → API-nycklar. En nyckel autentiserar som ditt konto — behandla den som ett lösenord. Återkalla den omedelbart om den läcker.

Nycklar för skarpa konton har prefixet ip_live_. Prefixet gör att du lätt känner igen dem i kod eller miljöfiler.

Hastighetsgränser & kvoter

~30

Förfrågningar per minut

30 förfrågningar/minut i stadigt flöde (burst: 30). Vid överskridande returneras 429 rate_limited med rubriken Retry-After.

Dagligen

Daglig säkringskvot

Pro-abonnemanget ger ett fast antal certifikat per dag. Kvoten nollställs varje dag. Vid överskridande returneras 429 quota_exceeded.

64 KB

Gräns för request body

JSON-innehållet i förfrågan får inte överstiga 64 KB. I praktiken ligger en URL långt under gränsen.

Kodexempel

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

Vanliga frågor

Hur lång tid tar det att skapa ett certifikat?

Vanligtvis 10–60 sekunder, beroende på hur snabbt målsidan laddas. POST-anropet blockerar tills certifikatet är klart — det finns inget pollingsteg.

Stöder API:et filcertifikat (PDF, bilduppladdningar)?

Det nuvarande API:et stöder endast certifiering av webbplatser (URL). Filuppladdning finns i webbgränssnittet på secure.instantproof.legal/certificates/new.

Kan jag verifiera ett certifikat som skapats via API:et?

Ja. PDF-filen som API:et skapar är identisk med en som skapats i webbgränssnittet. Dra den till instantproof.legal/certificate.html för att verifiera Ed25519-signaturen och RFC 3161-tidsstämpelkedjan.

Vad händer om URL:en inte går att nå?

Säkringstjänsten returnerar felet 502 capture_failed. Din dagskvot förbrukas inte.

Syns certifikat som skapats via API:et i webbpanelen?

Ja. Varje certifikat som skapats via API:et visas i din certifikatpanel under Mina webbplatscertifikat, tillsammans med certifikat som skapats i webbgränssnittet.