Zahteve na minuto
30 zahtev na minuto neprekinjeno (špica: 30). Pri preseganju se vrne 429 rate_limited z glavo Retry-After.
REST API InstantProof Vam omogoča programsko potrjevanje katerega koli javnega URL-ja. Overite se s ključem API (Bearer), pošljite POST z URL-jem in prejmite podpisano potrdilo PDF s celotnim paketom dokazov — z istim časovnim žigom RFC 3161 in podpisom Ed25519 kot v spletnem vmesniku.
Shranite spletno stran, posnemite sejo brskalnika ali potrdite datoteko.
Kriptografski žig in časovni žig pomagata razkriti poznejše spremembe.
Dokazni paket lahko neodvisno preveri kdorkoli.
Začnite z 10 € pozdravnega kredita. Obdržite kriptografsko opečaten dokazni paket, ki ga lahko prenesete in preverite.
Trije koraki od nič do podpisanega potrdila PDF.
Prijavite se, odprite Razvijalci → Ključi API in kliknite Ustvari ključ API. Ključ kopirajte — prikazan je samo enkrat.
Pošljite zahtevo POST s svojim URL-jem:
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"}'
Odgovor 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"
}
}
S svojim ključem API odprite URL links.certificate. Strežnik vrne preusmeritev 302 na vnaprej podpisan URL za prenos:
curl -L \
-H "Authorization: Bearer ip_live_xxxxxxxxxxxxxxxx" \
"https://secure.instantproof.legal/api/v1/certificates/def456…/download" \
-o certificate.pdf
Preneseni PDF je enako podpisano potrdilo PDF, kot ga ustvari spletni vmesnik, in ga je mogoče preveriti na /certificate.html.
Osnovni URL: https://secure.instantproof.legal
Vse končne točke vračajo JSON. Overjanje: Authorization: Bearer <key>.
Ustvari novo potrdilo za spletno mesto. Platforma zajame URL v brskalniku brez grafičnega vmesnika, ustvari omrežni dnevnik HAR in posnetek zaslona, podpiše manifest z Ed25519 in ga zasidra v kvalificiran časovni žig RFC 3161. Postopek traja 10–60 sekund.
| Polje | Tip | Opis | |
|---|---|---|---|
url | string | obvezno | Veljaven URL https://, ki ga želite potrditi. Mora biti javno dosegljiv. |
| Polje | Tip | Opis |
|---|---|---|
certificateId | string | Človeku berljiva oznaka potrdila (prikazana na PDF). |
recordingId | string | Notranji UUID posnetka. Uporabite ga v nadaljnjih klicih API. |
url | string | URL, ki ste ga poslali. |
finalUrl | string | URL po morebitnih preusmeritvah, kot ga vidi brskalnik. |
status | string | "ready" — potrdilo je takoj na voljo. |
links.self | string | Pot za pridobitev metapodatkov tega potrdila. |
links.certificate | string | Pot za prenos PDF. Zahteva overitev. |
| Stanje | napaka | Pomen |
|---|---|---|
| 400 | invalid_url | Polje url manjka ali ni veljaven naslov https://. |
| 400 | invalid_json | Telo zahteve ni veljaven JSON. |
| 401 | invalid_api_key | Glava Authorization manjka ali je neveljavna. |
| 402 | api_access_required | Vaš račun nima paketa Pro. Naročite se. |
| 403 | subscription_required | Spletna potrdila zahtevajo naročnino s pavšalno ceno. |
| 403 | insufficient_scope | Ključ API nima obsega certificates:write. |
| 413 | payload_too_large | Telo zahteve presega 64 KB. |
| 429 | quota_exceeded | Dnevna kvota zajemov prek API je dosežena. Ponastavi se vsak dan. |
| 429 | rate_limited | Preveč zahtev. Glejte glavo Retry-After. |
| 429 | service_busy | Storitev zajema je zasedena. Poskusite znova čez približno 30 sekund. |
| 502 | capture_failed | Brskalnik ni mogel naložiti URL-ja. |
| 502 | certification_failed | Zajem ni ustvaril uporabnih dokazov (npr. prazen HAR). |
Pridobi metapodatke potrdila, ki ste ga predhodno ustvarili.
| Parameter | Opis | |
|---|---|---|
recordingId | obvezno | recordingId, ki ga vrne POST /api/v1/certificates. |
| Polje | Tip | Opis |
|---|---|---|
certificateId | string | Človeku berljiva oznaka potrdila. |
recordingId | string | Notranji UUID posnetka. |
type | string | Vrsta posnetka (npr. "webcapture"). |
status | string | "ready", ko je potrdilo na voljo. |
url | string | URL, ki je bil potrjen. |
createdAt | string | Časovni žig ustvaritve ISO 8601. |
links | object | Poti self in certificate. |
Prenesite podpisano potrdilo PDF. Vrne 302 Found — sledite preusmeritvi, da prejmete datoteko. Uporabite curl -L ali requests.get(..., allow_redirects=True).
Vse zahteve API morajo vsebovati:
Authorization: Bearer ip_live_xxxxxxxxxxxxxxxx
Ključi se ustvarijo v Nastavitve → Razvijalci → Ključi API. Ključ se overja kot Vaš račun — ravnajte z njim kot z geslom. Če uide v javnost, ga takoj prekličite.
Ključi imajo za žive račune predpono ip_live_. Predpona Vam pomaga prepoznati jih v kodi ali okoljskih datotekah.
30 zahtev na minuto neprekinjeno (špica: 30). Pri preseganju se vrne 429 rate_limited z glavo Retry-After.
Paket Pro omogoča fiksno število izdanih potrdil na dan. Kvota se ponastavi vsak dan. Pri preseganju se vrne 429 quota_exceeded.
Telo zahteve JSON ne sme presegati 64 KB. V praksi je URL precej pod to omejitvijo.
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
Običajno 10–60 sekund, odvisno od časa nalaganja ciljne strani. Zahteva POST počaka, dokler potrdilo ni pripravljeno — koraka poizvedovanja ni.
Trenutni API podpira samo potrjevanje spletnih mest (URL). Nalaganje datotek je na voljo prek spletnega vmesnika na secure.instantproof.legal/certificates/new.
Da. PDF, ki ga ustvari API, je enak tistemu, ustvarjenemu prek spletnega vmesnika. Povlecite ga na instantproof.legal/certificate.html, da preverite podpis Ed25519 in verigo časovnega žiga RFC 3161.
Storitev zajema vrne napako 502 capture_failed. Vaša dnevna kvota se ne porabi.
Da. Vsako potrdilo, ustvarjeno prek API-ja, se prikaže v Vaši nadzorni plošči Potrdila pod Moja potrdila za spletna mesta, skupaj z morebitnimi potrdili, ustvarjenimi prek spletnega vmesnika.