Arendajale · REST API

Automatiseerige digitaalse sisu sertifitseerimist API kaudu

Jäädvustage · Pitseerige · Kontrollige

InstantProofi REST API võimaldab Teil sertifitseerida mis tahes avaliku URL-i programmeeritult. Autentige Bearer API-võtmega, tehke POST URL-ile ja saate allkirjastatud sertifikaadi PDF-i koos täieliku tõendipaketiga — sama RFC 3161 ajatempli ja Ed25519 allkirjaga nagu veebiliideses.

Proovige kohe, kontot pole vaja.Teie esimene tõend on tasuta · 10 € tervituskrediiti e-posti kinnitamisel · Kaarti pole vajaTuruletuleku pakkumine. Krediiti saab kasutada ka veebilehtede jäädvustamiseks või failide sertifitseerimiseks.
RESTJSON üle HTTPS-i
BearerAPI-võtmega autentimine
RFC 3161Kvalifitseeritud ajatemplid
API sertifitseerimise illustratsioon
  1. 01

    Jäädvustage

    Salvestage veebileht, salvestage brauseriseanss või sertifitseerige fail.

  2. 02

    Pitseerige

    Krüptograafiline pitser ja ajatempel aitavad hilisemad muudatused avastada.

  3. 03

    Kontrollige

    Igaüks saab tõendipaketti sõltumatult kontrollida.

Digitõendid. Lihtsalt tehtud.

Jäädvustage see, mis on oluline. Enne kui see muutub.

Alustage 10 € tervituskrediidiga. Hoidke krüptograafiliselt pitseeritud tõendipaketti, mida saate alla laadida ja kontrollida.

Jäädvustage oma esimene tõend →

Eeltingimused

1
Pro pakett või kõrgemAPI nõuab Pro tellimust (funktsioon api_access). Tellige siin.
2
API-võtiLooge see aadressil Seaded → API-võtmed. Kopeerige võti kohe — seda näidatakse ainult üks kord.
3
Sertifitseeritav https:// URLAPI sertifitseerib avalikult kättesaadavaid veebilehti. URL peab olema kehtiv https:// aadress.

Kiirstart

Kolm sammu nullist allkirjastatud sertifikaadi PDF-ini.

1. samm — looge API-võti

Logige sisse, minge jaotisse Developer → API keys ja klõpsake nuppu Create API key. Kopeerige võti — seda näidatakse ainult üks kord.

2. samm — looge sertifikaat

Saatke oma URL-iga POST-päring:

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

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

3. samm — laadige sertifikaadi PDF alla

Järgige URL-i links.certificate oma API-võtmega. Server tagastab ümbersuunamise 302 eelnevalt allkirjastatud allalaadimis-URL-ile:

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

Allalaaditud PDF on sama allkirjastatud sertifikaadi PDF, mille veebiliides loob ja mida saab kontrollida aadressil /certificate.html.

API viide

Baas-URL: https://secure.instantproof.legal
Kõik lõpp-punktid tagastavad JSON-i. Autentimine: Authorization: Bearer <key>.

POST /api/v1/certificates

Looge uus veebisaidi sertifikaat. Platvorm jäädvustab URL-i peata brauseris, koostab HAR-võrgulogi ja ekraanipildi, allkirjastab manifesti Ed25519-ga ja seob selle kvalifitseeritud RFC 3161 ajatempliga. Toiming võtab 10–60 sekundit.

Päringu keha (JSON)

VäliTüüpKirjeldus
urlstringkohustuslikKehtiv sertifitseeritav https:// URL. Peab olema avalikult kättesaadav.

Vastus 201 Created

VäliTüüpKirjeldus
certificateIdstringInimloetav sertifikaadi ID (kuvatakse PDF-il).
recordingIdstringSalvestuse sisemine UUID. Kasutage seda järgnevates API-kutsetes.
urlstringTeie esitatud URL.
finalUrlstringURL pärast võimalikke ümbersuunamisi, nagu brauser seda nägi.
statusstring"ready" — sertifikaat on kohe saadaval.
links.selfstringTee selle sertifikaadi metaandmete hankimiseks.
links.certificatestringTee PDF-i allalaadimiseks. Nõuab autentimist.

Veavastused

OlekvigaTähendus
400invalid_urlVäli url puudub või ei ole kehtiv https:// aadress.
400invalid_jsonPäringu keha ei ole kehtiv JSON.
401invalid_api_keyPuuduv või kehtetu päis Authorization.
402api_access_requiredTeie kontol ei ole Pro paketti. Tellige.
403subscription_requiredVeebisertifikaadid nõuavad püsitasuga tellimust.
403insufficient_scopeAPI-võtmel puudub õigus certificates:write.
413payload_too_largePäringu keha ületab 64 KB.
429quota_exceededPäevane API jäädvustuskvoot on täis. Lähtestub iga päev.
429rate_limitedLiiga palju päringuid. Vaadake päist Retry-After.
429service_busyJäädvustusteenus on täielikult koormatud. Proovige uuesti ~30 sekundi pärast.
502capture_failedBrauser ei suutnud URL-i laadida.
502certification_failedJäädvustus ei andnud kasutatavat tõendit (nt tühi HAR).

GET /api/v1/certificates/:recordingId

Hankige varem loodud sertifikaadi metaandmed.

Teeparameetrid

ParameeterKirjeldus
recordingIdkohustuslikrecordingId, mille tagastas POST /api/v1/certificates.

Vastus 200 OK

VäliTüüpKirjeldus
certificateIdstringInimloetav sertifikaadi ID.
recordingIdstringSalvestuse sisemine UUID.
typestringSalvestuse tüüp (nt "webcapture").
statusstring"ready", kui sertifikaat on saadaval.
urlstringSertifitseeritud URL.
createdAtstringLoomise ajatempel ISO 8601 vormingus.
linksobjectTeed self ja certificate.

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

Laadige alla allkirjastatud sertifikaadi PDF. Tagastab 302 Found — faili saamiseks järgige ümbersuunamist. Kasutage curl -L või requests.get(..., allow_redirects=True).

Autentimine

Kõik API-päringud peavad sisaldama:

Authorization: Bearer ip_live_xxxxxxxxxxxxxxxx

Võtmed luuakse aadressil Settings → Developer → API keys. Võti autentib Teie kontona — käsitlege seda nagu parooli. Lekke korral tühistage kohe.

Reaalsete kontode võtmete eesliide on ip_live_. Eesliide aitab neid koodis või keskkonnafailides ära tunda.

Päringupiirangud & kvoodid

~30

Päringuid minutis

30 päringut minutis püsivalt (hetkeline hüpe: 30). Ületamisel tagastatakse 429 rate_limited koos päisega Retry-After.

Päevas

Päevane jäädvustuskvoot

Pro pakett annab kindla arvu sertifikaadi loomisi päevas. Kvoot lähtestub iga päev. Ületamisel tagastatakse 429 quota_exceeded.

64 KB

Päringu keha piirang

JSON-päringu keha ei tohi ületada 64 KB. Praktikas jääb URL sellest piirist tublisti allapoole.

Koodinäited

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

Korduma kippuvad küsimused

Kui kaua sertifikaadi loomine aega võtab?

Tavaliselt 10–60 sekundit, sõltuvalt sihtlehe laadimisajast. POST-päring blokeerib, kuni sertifikaat on valmis — vahepealset pärimist ei ole.

Kas API toetab failisertifikaate (PDF, piltide üleslaadimine)?

Praegune API toetab ainult veebisaidi (URL-i) sertifitseerimist. Failide üleslaadimine on saadaval veebiliideses aadressil secure.instantproof.legal/certificates/new.

Kas saan API kaudu loodud sertifikaati kontrollida?

Jah. API loodud PDF on identne veebiliideses loodud PDF-iga. Lohistage see lehele instantproof.legal/certificate.html, et kontrollida Ed25519 allkirja ja RFC 3161 ajatempliahelat.

Mis juhtub, kui URL ei ole kättesaadav?

Jäädvustusteenus tagastab vea 502 capture_failed. Teie päevast kvooti ei kulutata.

Kas API kaudu loodud sertifikaadid on nähtavad veebipaneelis?

Jah. Iga API kaudu loodud sertifikaat ilmub Teie paneelis Certificates jaotises Minu veebisaidi sertifikaadid koos kõigi veebiliideses loodud sertifikaatidega.