Päringuid minutis
30 päringut minutis püsivalt (hetkeline hüpe: 30). Ületamisel tagastatakse 429 rate_limited koos päisega Retry-After.
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.
Salvestage veebileht, salvestage brauseriseanss või sertifitseerige fail.
Krüptograafiline pitser ja ajatempel aitavad hilisemad muudatused avastada.
Igaüks saab tõendipaketti sõltumatult kontrollida.
Alustage 10 € tervituskrediidiga. Hoidke krüptograafiliselt pitseeritud tõendipaketti, mida saate alla laadida ja kontrollida.
Kolm sammu nullist allkirjastatud sertifikaadi PDF-ini.
Logige sisse, minge jaotisse Developer → API keys ja klõpsake nuppu Create API key. Kopeerige võti — seda näidatakse ainult üks kord.
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"
}
}
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.
Baas-URL: https://secure.instantproof.legal
Kõik lõpp-punktid tagastavad JSON-i. Autentimine: Authorization: Bearer <key>.
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.
| Väli | Tüüp | Kirjeldus | |
|---|---|---|---|
url | string | kohustuslik | Kehtiv sertifitseeritav https:// URL. Peab olema avalikult kättesaadav. |
| Väli | Tüüp | Kirjeldus |
|---|---|---|
certificateId | string | Inimloetav sertifikaadi ID (kuvatakse PDF-il). |
recordingId | string | Salvestuse sisemine UUID. Kasutage seda järgnevates API-kutsetes. |
url | string | Teie esitatud URL. |
finalUrl | string | URL pärast võimalikke ümbersuunamisi, nagu brauser seda nägi. |
status | string | "ready" — sertifikaat on kohe saadaval. |
links.self | string | Tee selle sertifikaadi metaandmete hankimiseks. |
links.certificate | string | Tee PDF-i allalaadimiseks. Nõuab autentimist. |
| Olek | viga | Tähendus |
|---|---|---|
| 400 | invalid_url | Väli url puudub või ei ole kehtiv https:// aadress. |
| 400 | invalid_json | Päringu keha ei ole kehtiv JSON. |
| 401 | invalid_api_key | Puuduv või kehtetu päis Authorization. |
| 402 | api_access_required | Teie kontol ei ole Pro paketti. Tellige. |
| 403 | subscription_required | Veebisertifikaadid nõuavad püsitasuga tellimust. |
| 403 | insufficient_scope | API-võtmel puudub õigus certificates:write. |
| 413 | payload_too_large | Päringu keha ületab 64 KB. |
| 429 | quota_exceeded | Päevane API jäädvustuskvoot on täis. Lähtestub iga päev. |
| 429 | rate_limited | Liiga palju päringuid. Vaadake päist Retry-After. |
| 429 | service_busy | Jäädvustusteenus on täielikult koormatud. Proovige uuesti ~30 sekundi pärast. |
| 502 | capture_failed | Brauser ei suutnud URL-i laadida. |
| 502 | certification_failed | Jäädvustus ei andnud kasutatavat tõendit (nt tühi HAR). |
Hankige varem loodud sertifikaadi metaandmed.
| Parameeter | Kirjeldus | |
|---|---|---|
recordingId | kohustuslik | recordingId, mille tagastas POST /api/v1/certificates. |
| Väli | Tüüp | Kirjeldus |
|---|---|---|
certificateId | string | Inimloetav sertifikaadi ID. |
recordingId | string | Salvestuse sisemine UUID. |
type | string | Salvestuse tüüp (nt "webcapture"). |
status | string | "ready", kui sertifikaat on saadaval. |
url | string | Sertifitseeritud URL. |
createdAt | string | Loomise ajatempel ISO 8601 vormingus. |
links | object | Teed self ja certificate. |
Laadige alla allkirjastatud sertifikaadi PDF. Tagastab 302 Found — faili saamiseks järgige ümbersuunamist. Kasutage curl -L või requests.get(..., allow_redirects=True).
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.
30 päringut minutis püsivalt (hetkeline hüpe: 30). Ületamisel tagastatakse 429 rate_limited koos päisega Retry-After.
Pro pakett annab kindla arvu sertifikaadi loomisi päevas. Kvoot lähtestub iga päev. Ületamisel tagastatakse 429 quota_exceeded.
JSON-päringu keha ei tohi ületada 64 KB. Praktikas jääb URL sellest piirist tublisti allapoole.
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
Tavaliselt 10–60 sekundit, sõltuvalt sihtlehe laadimisajast. POST-päring blokeerib, kuni sertifikaat on valmis — vahepealset pärimist ei ole.
Praegune API toetab ainult veebisaidi (URL-i) sertifitseerimist. Failide üleslaadimine on saadaval veebiliideses aadressil secure.instantproof.legal/certificates/new.
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.
Jäädvustusteenus tagastab vea 502 capture_failed. Teie päevast kvooti ei kulutata.
Jah. Iga API kaudu loodud sertifikaat ilmub Teie paneelis Certificates jaotises Minu veebisaidi sertifikaadid koos kõigi veebiliideses loodud sertifikaatidega.