Požiadavky za minútu
30 požiadaviek za minútu trvalo (nárazovo: 30). Pri prekročení sa vráti 429 rate_limited s hlavičkou Retry-After.
REST API služby InstantProof umožňuje programovo certifikovať ľubovoľnú verejnú URL. Autentifikujte sa kľúčom API typu Bearer, odošlite URL metódou POST a získajte podpísaný certifikát PDF s úplným balíkom dôkazov — rovnakú časovú pečiatku RFC 3161 a podpis Ed25519 ako vo webovom rozhraní.
Uložte webovú stránku, zaznamenajte reláciu prehliadača alebo certifikujte súbor.
Kryptografická pečať a časová pečiatka pomáhajú odhaliť neskoršie zmeny.
Dôkazný balík môže nezávisle skontrolovať ktokoľvek.
Začnite s uvítacím kreditom 10 €. Získajte kryptograficky zapečatený dôkazný balík, ktorý si môžete stiahnuť a overiť.
Tri kroky od nuly k podpísanému certifikátu PDF.
Prihláste sa, prejdite do Pre vývojárov → Kľúče API a kliknite na Vytvoriť kľúč API. Kľúč skopírujte — zobrazí sa iba raz.
Odošlite požiadavku POST so svojou 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"}'
Odpoveď 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"
}
}
Otvorte URL links.certificate so svojím kľúčom API. Server vráti presmerovanie 302 na vopred podpísanú URL na stiahnutie:
curl -L \
-H "Authorization: Bearer ip_live_xxxxxxxxxxxxxxxx" \
"https://secure.instantproof.legal/api/v1/certificates/def456…/download" \
-o certificate.pdf
Stiahnuté PDF je ten istý podpísaný certifikát PDF, aký vytvára webové rozhranie, a možno ho overiť na /certificate.html.
Základná URL: https://secure.instantproof.legal
Všetky koncové body vracajú JSON. Autentifikácia: Authorization: Bearer <key>.
Vytvorí nový certifikát webovej stránky. Platforma zachytí URL v headless prehliadači, vytvorí sieťový log HAR a snímku obrazovky, podpíše manifest pomocou Ed25519 a ukotví ho v kvalifikovanej časovej pečiatke RFC 3161. Operácia trvá 10 – 60 sekúnd.
| Pole | Typ | Popis | |
|---|---|---|---|
url | string | povinné | Platná URL https:// na certifikáciu. Musí byť verejne dostupná. |
| Pole | Typ | Popis |
|---|---|---|
certificateId | string | Čitateľný identifikátor certifikátu (zobrazený na PDF). |
recordingId | string | Interné UUID záznamu. Použite ho v ďalších volaniach API. |
url | string | URL, ktorú ste odoslali. |
finalUrl | string | URL po všetkých presmerovaniach, ako ju videl prehliadač. |
status | string | "ready" — certifikát je okamžite k dispozícii. |
links.self | string | Cesta na získanie metaúdajov tohto certifikátu. |
links.certificate | string | Cesta na stiahnutie PDF. Vyžaduje autentifikáciu. |
| Stav | chyba | Význam |
|---|---|---|
| 400 | invalid_url | Pole url chýba alebo nie je platná adresa https://. |
| 400 | invalid_json | Telo požiadavky nie je platný JSON. |
| 401 | invalid_api_key | Chýbajúca alebo neplatná hlavička Authorization. |
| 402 | api_access_required | Váš účet nemá plán Pro. Predplatiť. |
| 403 | subscription_required | Webové certifikáty vyžadujú predplatné s paušálnou sadzbou. |
| 403 | insufficient_scope | Kľúču API chýba rozsah certificates:write. |
| 413 | payload_too_large | Telo požiadavky presahuje 64 KB. |
| 429 | quota_exceeded | Bol dosiahnutý denný limit zachytení cez API. Obnovuje sa každý deň. |
| 429 | rate_limited | Príliš veľa požiadaviek. Pozrite si hlavičku Retry-After. |
| 429 | service_busy | Služba zachytenia je plne vyťažená. Skúste znova približne o 30 sekúnd. |
| 502 | capture_failed | Prehliadač nedokázal načítať URL. |
| 502 | certification_failed | Zachytenie nevytvorilo použiteľný dôkaz (napr. prázdny HAR). |
Získa metaúdaje certifikátu, ktorý ste predtým vytvorili.
| Parameter | Popis | |
|---|---|---|
recordingId | povinné | Hodnota recordingId vrátená metódou POST /api/v1/certificates. |
| Pole | Typ | Popis |
|---|---|---|
certificateId | string | Čitateľný identifikátor certifikátu. |
recordingId | string | Interné UUID záznamu. |
type | string | Typ záznamu (napr. "webcapture"). |
status | string | "ready", keď je certifikát k dispozícii. |
url | string | URL, ktorá bola certifikovaná. |
createdAt | string | Časová pečiatka vytvorenia vo formáte ISO 8601. |
links | object | Cesty self a certificate. |
Stiahne podpísaný certifikát PDF. Vráti 302 Found — presmerovanie nasledujte, aby ste získali súbor. Použite curl -L alebo requests.get(..., allow_redirects=True).
Všetky požiadavky API musia obsahovať:
Authorization: Bearer ip_live_xxxxxxxxxxxxxxxx
Kľúče sa vytvárajú v Nastavenia → Pre vývojárov → Kľúče API. Kľúč sa autentifikuje ako váš účet — zaobchádzajte s ním ako s heslom. Ak unikne, okamžite ho zrušte.
Kľúče pre ostré účty majú predponu ip_live_. Predpona vám pomáha rozpoznať ich v kóde alebo v súboroch s premennými prostredia.
30 požiadaviek za minútu trvalo (nárazovo: 30). Pri prekročení sa vráti 429 rate_limited s hlavičkou Retry-After.
Plán Pro poskytuje pevný počet vytvorených certifikátov za deň. Limit sa obnovuje každý deň. Pri prekročení sa vráti 429 quota_exceeded.
Telo požiadavky vo formáte JSON nesmie presiahnuť 64 KB. V praxi je URL hlboko pod týmto limitom.
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
Zvyčajne 10 – 60 sekúnd, podľa času načítania cieľovej stránky. Požiadavka POST čaká, kým nie je certifikát hotový — nie je potrebné dopytovanie.
Aktuálne API podporuje iba certifikáciu webových stránok (URL). Nahrávanie súborov je k dispozícii vo webovom rozhraní na secure.instantproof.legal/certificates/new.
Áno. PDF vytvorené cez API je rovnaké ako to, ktoré vznikne vo webovom rozhraní. Presuňte ho na instantproof.legal/certificate.html a overte podpis Ed25519 a reťazec časovej pečiatky RFC 3161.
Služba zachytenia vráti chybu 502 capture_failed. Váš denný limit sa nespotrebuje.
Áno. Každý certifikát vytvorený cez API sa zobrazí vo vašom prehľade Certifikátov v časti Moje certifikáty webových stránok, spolu s certifikátmi vytvorenými vo webovom rozhraní.