Pro vývojáře · REST API

Automatizujte certifikaci digitálního obsahu přes API

Zachyťte · Zapečeťte · Ověřte

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í.

Vyzkoušejte ihned, bez účtu.První důkaz zdarma · uvítací kredit 10 € po potvrzení e-mailu · Bez platební kartyÚvodní nabídka. Kredit lze využít i na zachycení webových stránek nebo certifikaci souborů.
RESTJSON přes HTTPS
BearerOvěřování klíčem API
RFC 3161Kvalifikovaná časová razítka
Ilustrace certifikace přes API
  1. 01

    Zachyťte

    Uložte webovou stránku, zaznamenejte relaci prohlížeče nebo certifikujte soubor.

  2. 02

    Zapečeťte

    Kryptografická pečeť a časové razítko pomáhají odhalit pozdější změny.

  3. 03

    Ověřte

    Kdokoli může balíček důkazů nezávisle zkontrolovat.

Digitální důkazy. Jednoduše.

Zachyťte, na čem záleží. Dřív, než se to změní.

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.

Zachyťte svůj první důkaz →

Předpoklady

1
Tarif Pro nebo vyššíAPI vyžaduje předplatné Pro (funkce api_access). Předplatit zde.
2
Klíč APIVytvořte jej v Nastavení → Klíče API. Klíč ihned zkopírujte — zobrazí se pouze jednou.
3
URL začínající https:// k certifikaciAPI certifikuje veřejně dostupné webové stránky. URL musí být platná adresa začínající https://.

Rychlý start

Tři kroky od nuly k podepsanému certifikátu PDF.

Krok 1 — Vytvořte klíč API

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.

Krok 2 — Vytvořte certifikát

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

Krok 3 — Stáhněte certifikát PDF

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.

Referenční příručka API

Základní URL: https://secure.instantproof.legal
Všechny koncové body vracejí JSON. Ověřování: Authorization: Bearer <key>.

POST /api/v1/certificates

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.

Tělo požadavku (JSON)

PoleTypPopis
urlstringpovinnéPlatná URL začínající https://, která se má certifikovat. Musí být veřejně dostupná.

Odpověď 201 Created

PoleTypPopis
certificateIdstringČitelné ID certifikátu (uvedené v PDF).
recordingIdstringInterní UUID záznamu. Používá se v dalších voláních API.
urlstringOdeslaná URL.
finalUrlstringURL po všech přesměrováních, jak ji viděl prohlížeč.
statusstring"ready" — certifikát je ihned k dispozici.
links.selfstringCesta k metadatům tohoto certifikátu.
links.certificatestringCesta ke stažení PDF. Vyžaduje ověření.

Chybové odpovědi

StavchybaVýznam
400invalid_urlPole url chybí nebo není platná adresa začínající https://.
400invalid_jsonTělo požadavku není platný JSON.
401invalid_api_keyChybějící nebo neplatná hlavička Authorization.
402api_access_requiredVáš účet nemá tarif Pro. Předplatit.
403subscription_requiredWebové certifikáty vyžadují předplatné s paušální cenou.
403insufficient_scopeKlíč API nemá oprávnění certificates:write.
413payload_too_largeTělo požadavku přesahuje 64 KB.
429quota_exceededByl dosažen denní limit pořízení přes API. Obnovuje se každý den.
429rate_limitedPříliš mnoho požadavků. Viz hlavička Retry-After.
429service_busySlužba pořizování je plně vytížena. Zkuste to znovu za ~30 sekund.
502capture_failedProhlížeč nemohl URL načíst.
502certification_failedPořízení nevytvořilo žádný použitelný důkaz (např. prázdný HAR).

GET /api/v1/certificates/:recordingId

Načte metadata dříve vytvořeného certifikátu.

Parametry cesty

ParametrPopis
recordingIdpovinnérecordingId vrácené voláním POST /api/v1/certificates.

Odpověď 200 OK

PoleTypPopis
certificateIdstringČitelné ID certifikátu.
recordingIdstringInterní UUID záznamu.
typestringTyp záznamu (např. "webcapture").
statusstring"ready", jakmile je certifikát k dispozici.
urlstringCertifikovaná URL.
createdAtstringČasové razítko vytvoření ve formátu ISO 8601.
linksobjectCesty self a certificate.

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

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).

Ověřování

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í.

Limity četnosti & kvóty

~30

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.

Denně

Denní limit pořízení

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.

64 KB

Limit těla požadavku

Tělo požadavku ve formátu JSON nesmí přesáhnout 64 KB. V praxi je URL hluboko pod tímto limitem.

Příklady kódu

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

Často kladené otázky

Jak dlouho trvá vytvoření certifikátu?

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.

Podporuje API certifikáty souborů (PDF, nahrané obrázky)?

Současné API podporuje pouze certifikaci webů (URL). Nahrávání souborů je dostupné ve webovém rozhraní na secure.instantproof.legal/certificates/new.

Mohu ověřit certifikát vytvořený přes API?

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.

Co se stane, když je URL nedostupná?

Služba pořizování vrátí chybu 502 capture_failed. Váš denní limit se nespotřebuje.

Jsou certifikáty vytvořené přes API vidět ve webovém přehledu?

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í.