Požadavků za minutu
30 požadavků za minutu trvale (nárazově: 30). Při překročení se vrací 429 rate_limited s hlavičkou Retry-After.
REST API InstantProof vám umožňuje programově certifikovat libovolnou veřejnou URL. Ověřte se klíčem API typu Bearer, odešlete POST s URL a získejte podepsaný certifikát PDF s kompletním balíčkem důkazů — se stejným časovým razítkem RFC 3161 a podpisem Ed25519 jako ve webovém rozhraní.
Uložte webovou stránku, zaznamenejte relaci prohlížeče nebo certifikujte soubor.
Kryptografická pečeť a časové razítko pomáhají odhalit pozdější změny.
Kdokoli může balíček důkazů nezávisle zkontrolovat.
Začněte s uvítacím kreditem 10 €. Získejte kryptograficky zapečetěný balíček důkazů, který si můžete stáhnout a ověřit.
Tři kroky od nuly k podepsanému certifikátu PDF.
Přihlaste se, přejděte do Pro vývojáře → Klíče API a klikněte na Vytvořit klíč API. Klíč zkopírujte — zobrazí se pouze jednou.
Odešlete požadavek POST se svou 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"}'
Odpověď 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"
}
}
Otevřete URL z links.certificate se svým klíčem API. Server vrátí přesměrování 302 na předem podepsanou URL ke stažení:
curl -L \
-H "Authorization: Bearer ip_live_xxxxxxxxxxxxxxxx" \
"https://secure.instantproof.legal/api/v1/certificates/def456…/download" \
-o certificate.pdf
Stažené PDF je tentýž podepsaný certifikát PDF, který vytváří webové rozhraní, ověřitelný na /certificate.html.
Základní URL: https://secure.instantproof.legal
Všechny koncové body vracejí JSON. Ověřování: Authorization: Bearer <key>.
Vytvoří nový certifikát webu. Platforma načte URL v bezhlavém prohlížeči, vytvoří síťový log HAR a snímek obrazovky, podepíše manifest pomocí Ed25519 a ukotví jej v kvalifikovaném časovém razítku RFC 3161. Operace trvá 10–60 sekund.
| Pole | Typ | Popis | |
|---|---|---|---|
url | string | povinné | Platná URL začínající https://, která se má certifikovat. Musí být veřejně dostupná. |
| Pole | Typ | Popis |
|---|---|---|
certificateId | string | Čitelné ID certifikátu (uvedené v PDF). |
recordingId | string | Interní UUID záznamu. Používá se v dalších voláních API. |
url | string | Odeslaná URL. |
finalUrl | string | URL po všech přesměrováních, jak ji viděl prohlížeč. |
status | string | "ready" — certifikát je ihned k dispozici. |
links.self | string | Cesta k metadatům tohoto certifikátu. |
links.certificate | string | Cesta ke stažení PDF. Vyžaduje ověření. |
| Stav | chyba | Význam |
|---|---|---|
| 400 | invalid_url | Pole url chybí nebo není platná adresa začínající https://. |
| 400 | invalid_json | Tělo požadavku není platný JSON. |
| 401 | invalid_api_key | Chybějící nebo neplatná hlavička Authorization. |
| 402 | api_access_required | Váš účet nemá tarif Pro. Předplatit. |
| 403 | subscription_required | Webové certifikáty vyžadují předplatné s paušální cenou. |
| 403 | insufficient_scope | Klíč API nemá oprávnění certificates:write. |
| 413 | payload_too_large | Tělo požadavku přesahuje 64 KB. |
| 429 | quota_exceeded | Byl dosažen denní limit pořízení přes API. Obnovuje se každý den. |
| 429 | rate_limited | Příliš mnoho požadavků. Viz hlavička Retry-After. |
| 429 | service_busy | Služba pořizování je plně vytížena. Zkuste to znovu za ~30 sekund. |
| 502 | capture_failed | Prohlížeč nemohl URL načíst. |
| 502 | certification_failed | Pořízení nevytvořilo žádný použitelný důkaz (např. prázdný HAR). |
Načte metadata dříve vytvořeného certifikátu.
| Parametr | Popis | |
|---|---|---|
recordingId | povinné | recordingId vrácené voláním POST /api/v1/certificates. |
| Pole | Typ | Popis |
|---|---|---|
certificateId | string | Čitelné ID certifikátu. |
recordingId | string | Interní UUID záznamu. |
type | string | Typ záznamu (např. "webcapture"). |
status | string | "ready", jakmile je certifikát k dispozici. |
url | string | Certifikovaná URL. |
createdAt | string | Časové razítko vytvoření ve formátu ISO 8601. |
links | object | Cesty self a certificate. |
Stáhne podepsaný certifikát PDF. Vrací 302 Found — pro získání souboru následujte přesměrování. Použijte curl -L nebo requests.get(..., allow_redirects=True).
Všechny požadavky na API musí obsahovat:
Authorization: Bearer ip_live_xxxxxxxxxxxxxxxx
Klíče se vytvářejí v Nastavení → Pro vývojáře → Klíče API. Klíč ověřuje jako váš účet — zacházejte s ním jako s heslem. Při úniku jej okamžitě zrušte.
Klíče mají u ostrých účtů předponu ip_live_. Předpona vám pomůže rozpoznat je v kódu nebo v souborech prostředí.
30 požadavků za minutu trvale (nárazově: 30). Při překročení se vrací 429 rate_limited s hlavičkou Retry-After.
Tarif Pro poskytuje pevný počet vytvořených certifikátů za den. Limit se každý den obnovuje. Při překročení se vrací 429 quota_exceeded.
Tělo požadavku ve formátu JSON nesmí přesáhnout 64 KB. V praxi je URL hluboko pod tímto limitem.
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
Obvykle 10–60 sekund, podle doby načítání cílové stránky. Požadavek POST čeká, dokud není certifikát hotový — žádné opakované dotazování není potřeba.
Současné API podporuje pouze certifikaci webů (URL). Nahrávání souborů je dostupné ve webovém rozhraní na secure.instantproof.legal/certificates/new.
Ano. PDF vytvořené přes API je totožné s PDF vytvořeným ve webovém rozhraní. Přetáhněte jej na instantproof.legal/certificate.html a ověřte podpis Ed25519 a řetězec časového razítka RFC 3161.
Služba pořizování vrátí chybu 502 capture_failed. Váš denní limit se nespotřebuje.
Ano. Každý certifikát vytvořený přes API se zobrazí v přehledu Certifikátů v části Moje certifikáty webů, spolu s certifikáty vytvořenými ve webovém rozhraní.