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.
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.
Spara en webbsida, spela in en webbläsarsession eller certifiera en fil.
Ett kryptografiskt sigill och en tidsstämpel gör att senare ändringar kan upptäckas.
Vem som helst kan kontrollera bevispaketet oberoende.
Börja med 10 € i välkomstkredit. Behåll ett kryptografiskt förseglat bevispaket som du kan ladda ner och verifiera.
Tre steg från noll till ett signerat certifikat i PDF.
Logga in, gå till Utvecklare → API-nycklar och klicka på Skapa API-nyckel. Kopiera nyckeln — den visas bara en gång.
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"
}
}
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.
Bas-URL: https://secure.instantproof.legal
Alla endpoints returnerar JSON. Autentisering: Authorization: Bearer <key>.
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.
| Fält | Typ | Beskrivning | |
|---|---|---|---|
url | string | obligatoriskt | En giltig https://-URL att certifiera. Måste vara offentligt nåbar. |
| Fält | Typ | Beskrivning |
|---|---|---|
certificateId | string | Läsbart certifikat-ID (visas på PDF-filen). |
recordingId | string | Internt UUID för inspelningen. Används i efterföljande API-anrop. |
url | string | URL:en du skickade in. |
finalUrl | string | URL:en efter eventuella omdirigeringar, som webbläsaren såg den. |
status | string | "ready" — certifikatet är tillgängligt direkt. |
links.self | string | Sökväg för att hämta certifikatets metadata. |
links.certificate | string | Sökväg för att ladda ner PDF-filen. Kräver autentisering. |
| Status | error | Betydelse |
|---|---|---|
| 400 | invalid_url | Fältet url saknas eller är inte en giltig https://-adress. |
| 400 | invalid_json | Request body är inte giltig JSON. |
| 401 | invalid_api_key | Rubriken Authorization saknas eller är ogiltig. |
| 402 | api_access_required | Ditt konto har inte Pro-abonnemang. Teckna abonnemang. |
| 403 | subscription_required | Webbcertifikat kräver ett abonnemang med fast avgift. |
| 403 | insufficient_scope | API-nyckeln saknar behörigheten certificates:write. |
| 413 | payload_too_large | Request body överstiger 64 KB. |
| 429 | quota_exceeded | Dagskvoten för API-säkringar är nådd. Nollställs varje dag. |
| 429 | rate_limited | För många förfrågningar. Se rubriken Retry-After. |
| 429 | service_busy | Säkringstjänsten är fullbelagd. Försök igen efter ca 30 sekunder. |
| 502 | capture_failed | Webbläsaren kunde inte ladda URL:en. |
| 502 | certification_failed | Säkringen gav inget användbart bevis (t.ex. tom HAR). |
Hämta metadata för ett certifikat som du tidigare skapat.
| Parameter | Beskrivning | |
|---|---|---|
recordingId | obligatoriskt | recordingId som returneras av POST /api/v1/certificates. |
| Fält | Typ | Beskrivning |
|---|---|---|
certificateId | string | Läsbart certifikat-ID. |
recordingId | string | Internt UUID för inspelningen. |
type | string | Inspelningstyp (t.ex. "webcapture"). |
status | string | "ready" när certifikatet är tillgängligt. |
url | string | URL:en som certifierades. |
createdAt | string | Tidsstämpel för skapandet enligt ISO 8601. |
links | object | Sökvägarna self och certificate. |
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).
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.
30 förfrågningar/minut i stadigt flöde (burst: 30). Vid överskridande returneras 429 rate_limited med rubriken Retry-After.
Pro-abonnemanget ger ett fast antal certifikat per dag. Kvoten nollställs varje dag. Vid överskridande returneras 429 quota_exceeded.
JSON-innehållet i förfrågan får inte överstiga 64 KB. I praktiken ligger en URL långt under gränsen.
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
Vanligtvis 10–60 sekunder, beroende på hur snabbt målsidan laddas. POST-anropet blockerar tills certifikatet är klart — det finns inget pollingsteg.
Det nuvarande API:et stöder endast certifiering av webbplatser (URL). Filuppladdning finns i webbgränssnittet på secure.instantproof.legal/certificates/new.
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.
Säkringstjänsten returnerar felet 502 capture_failed. Din dagskvot förbrukas inte.
Ja. Varje certifikat som skapats via API:et visas i din certifikatpanel under Mina webbplatscertifikat, tillsammans med certifikat som skapats i webbgränssnittet.