Pre vývojárov · REST API

Automatizujte certifikáciu digitálneho obsahu cez API

Zachyťte · Zapečaťte · Overte

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

Vyskúšajte hneď, bez účtu.Váš prvý dôkaz je zadarmo · uvítací kredit 10 € po potvrdení e-mailu · bez platobnej kartyÚvodná ponuka. Kredit možno použiť aj na zachytenie webových stránok alebo certifikáciu súborov.
RESTJSON cez HTTPS
BearerAutentifikácia kľúčom API
RFC 3161Kvalifikované časové pečiatky
Ilustrácia certifikácie cez API
  1. 01

    Zachyťte

    Uložte webovú stránku, zaznamenajte reláciu prehliadača alebo certifikujte súbor.

  2. 02

    Zapečaťte

    Kryptografická pečať a časová pečiatka pomáhajú odhaliť neskoršie zmeny.

  3. 03

    Overte

    Dôkazný balík môže nezávisle skontrolovať ktokoľvek.

Digitálny dôkaz. Jednoducho.

Zachyťte, na čom záleží. Kým sa to zmení.

Začnite s uvítacím kreditom 10 €. Získajte kryptograficky zapečatený dôkazný balík, ktorý si môžete stiahnuť a overiť.

Zachyťte svoj prvý dôkaz →

Predpoklady

1
Plán Pro alebo vyššíAPI vyžaduje predplatné Pro (funkcia api_access). Predplatiť tu.
2
Kľúč APIVytvoríte ho v Nastavenia → Kľúče API. Kľúč ihneď skopírujte — zobrazí sa iba raz.
3
URL https:// na certifikáciuAPI certifikuje verejne dostupné webové stránky. URL musí byť platná adresa https://.

Rýchly štart

Tri kroky od nuly k podpísanému certifikátu PDF.

Krok 1 — Vytvorte kľúč API

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.

Krok 2 — Vytvorte certifikát

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

Krok 3 — Stiahnite certifikát PDF

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.

Referenčná príručka API

Základná URL: https://secure.instantproof.legal
Všetky koncové body vracajú JSON. Autentifikácia: Authorization: Bearer <key>.

POST /api/v1/certificates

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.

Telo požiadavky (JSON)

PoleTypPopis
urlstringpovinnéPlatná URL https:// na certifikáciu. Musí byť verejne dostupná.

Odpoveď 201 Created

PoleTypPopis
certificateIdstringČitateľný identifikátor certifikátu (zobrazený na PDF).
recordingIdstringInterné UUID záznamu. Použite ho v ďalších volaniach API.
urlstringURL, ktorú ste odoslali.
finalUrlstringURL po všetkých presmerovaniach, ako ju videl prehliadač.
statusstring"ready" — certifikát je okamžite k dispozícii.
links.selfstringCesta na získanie metaúdajov tohto certifikátu.
links.certificatestringCesta na stiahnutie PDF. Vyžaduje autentifikáciu.

Chybové odpovede

StavchybaVýznam
400invalid_urlPole url chýba alebo nie je platná adresa https://.
400invalid_jsonTelo požiadavky nie je platný JSON.
401invalid_api_keyChýbajúca alebo neplatná hlavička Authorization.
402api_access_requiredVáš účet nemá plán Pro. Predplatiť.
403subscription_requiredWebové certifikáty vyžadujú predplatné s paušálnou sadzbou.
403insufficient_scopeKľúču API chýba rozsah certificates:write.
413payload_too_largeTelo požiadavky presahuje 64 KB.
429quota_exceededBol dosiahnutý denný limit zachytení cez API. Obnovuje sa každý deň.
429rate_limitedPríliš veľa požiadaviek. Pozrite si hlavičku Retry-After.
429service_busySlužba zachytenia je plne vyťažená. Skúste znova približne o 30 sekúnd.
502capture_failedPrehliadač nedokázal načítať URL.
502certification_failedZachytenie nevytvorilo použiteľný dôkaz (napr. prázdny HAR).

GET /api/v1/certificates/:recordingId

Získa metaúdaje certifikátu, ktorý ste predtým vytvorili.

Parametre cesty

ParameterPopis
recordingIdpovinnéHodnota recordingId vrátená metódou POST /api/v1/certificates.

Odpoveď 200 OK

PoleTypPopis
certificateIdstringČitateľný identifikátor certifikátu.
recordingIdstringInterné UUID záznamu.
typestringTyp záznamu (napr. "webcapture").
statusstring"ready", keď je certifikát k dispozícii.
urlstringURL, ktorá bola certifikovaná.
createdAtstringČasová pečiatka vytvorenia vo formáte ISO 8601.
linksobjectCesty self a certificate.

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

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

Autentifikácia

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.

Limity rýchlosti & kvóty

~30

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.

Denne

Denný limit zachytení

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.

64 KB

Limit tela požiadavky

Telo požiadavky vo formáte JSON nesmie presiahnuť 64 KB. V praxi je URL hlboko pod týmto limitom.

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

Ako dlho trvá vytvorenie certifikátu?

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.

Podporuje API certifikáty súborov (PDF, nahrávanie obrázkov)?

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.

Môžem overiť certifikát vytvorený cez API?

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

Čo sa stane, ak je URL nedostupná?

Služba zachytenia vráti chybu 502 capture_failed. Váš denný limit sa nespotrebuje.

Sú certifikáty vytvorené cez API viditeľné vo webovom prehľade?

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