Fejlesztőknek · REST API

Automatizálja a digitális tartalom tanúsítását az API-val

Rögzítse · Pecsételje le · Ellenőrizze

Az InstantProof REST API lehetővé teszi bármely nyilvános URL programozott tanúsítását. Hitelesítsen Bearer API-kulccsal, POST-olja az URL-t, és kapjon vissza aláírt PDF-tanúsítványt teljes bizonyítékcsomaggal — ugyanazzal az RFC 3161 időbélyeggel és Ed25519 aláírással, mint a webes felületen.

Próbálja ki most, fiók nélkül.Az első bizonyíték ingyenes · 10 € üdvözlő kredit az e-mail-cím megerősítésekor · Bankkártya nem szükségesInduló ajánlat. A kredit weboldal-rögzítésekre és fájltanúsításra is felhasználható.
RESTJSON HTTPS felett
BearerAPI-kulcsos hitelesítés
RFC 3161Minősített időbélyegek
Az API-s tanúsítás szemléltetése
  1. 01

    Rögzítse

    Mentsen el egy weboldalt, rögzítsen egy böngészőmunkamenetet, vagy tanúsítson egy fájlt.

  2. 02

    Pecsételje le

    A kriptográfiai pecsét és az időbélyeg segít felfedni a későbbi módosításokat.

  3. 03

    Ellenőrizze

    A bizonyítékcsomagot bárki függetlenül ellenőrizheti.

Digitális bizonyíték. Egyszerűen.

Rögzítse, ami számít. Mielőtt megváltozik.

Kezdje 10 € üdvözlő kredittel. Őrizzen meg egy kriptográfiailag lepecsételt bizonyítékcsomagot, amelyet letölthet és ellenőrizhet.

Rögzítse az első bizonyítékát →

Előfeltételek

1
Pro vagy magasabb csomagAz API használatához Pro előfizetés szükséges (api_access funkció). Feliratkozás itt.
2
Egy API-kulcsLétrehozhatja itt: Beállítások → API-kulcsok. Másolja ki azonnal a kulcsot — csak egyszer jelenik meg.
3
Egy tanúsítandó https:// URLAz API nyilvánosan elérhető weboldalakat tanúsít. Az URL-nek érvényes https:// címnek kell lennie.

Gyorsindítás

Három lépés a nulláról az aláírt PDF-tanúsítványig.

1. lépés — API-kulcs létrehozása

Jelentkezzen be, lépjen a Developer → API keys oldalra, és kattintson a Create API key gombra. Másolja ki a kulcsot — csak egyszer jelenik meg.

2. lépés — Tanúsítvány létrehozása

Küldjön egy POST kérést az URL-jével:

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

Válasz 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"
  }
}

3. lépés — A PDF-tanúsítvány letöltése

Kövesse a links.certificate URL-t az API-kulcsával. A szerver 302-es átirányítást ad egy előre aláírt letöltési URL-re:

curl -L \
  -H "Authorization: Bearer ip_live_xxxxxxxxxxxxxxxx" \
  "https://secure.instantproof.legal/api/v1/certificates/def456…/download" \
  -o certificate.pdf

A letöltött PDF ugyanaz az aláírt PDF-tanúsítvány, amelyet a webes felület állít elő, és a /certificate.html oldalon ellenőrizhető.

API-referencia

Alap-URL: https://secure.instantproof.legal
Minden végpont JSON-t ad vissza. Hitelesítés: Authorization: Bearer <key>.

POST /api/v1/certificates

Új weboldal-tanúsítvány létrehozása. A platform fej nélküli böngészőben rögzíti az URL-t, HAR hálózati naplót és képernyőképet készít, Ed25519-tel aláírja a jegyzéket, és minősített RFC 3161 időbélyeghez horgonyozza. A művelet 10–60 másodpercig tart.

Kérés törzse (JSON)

MezőTípusLeírás
urlstringkötelezőA tanúsítandó érvényes https:// URL. Nyilvánosan elérhetőnek kell lennie.

Válasz 201 Created

MezőTípusLeírás
certificateIdstringEmber által olvasható tanúsítvány-azonosító (a PDF-en látható).
recordingIdstringBelső felvétel-UUID. A későbbi API-hívásokban használja.
urlstringAz Ön által beküldött URL.
finalUrlstringAz URL az esetleges átirányítások után, ahogyan a böngésző látta.
statusstring"ready" — a tanúsítvány azonnal elérhető.
links.selfstringA tanúsítvány metaadatainak lekérési útvonala.
links.certificatestringA PDF letöltési útvonala. Hitelesítés szükséges.

Hibaválaszok

ÁllapoterrorJelentés
400invalid_urlAz url mező hiányzik, vagy nem érvényes https:// cím.
400invalid_jsonA kérés törzse nem érvényes JSON.
401invalid_api_keyHiányzó vagy érvénytelen Authorization fejléc.
402api_access_requiredFiókja nem rendelkezik Pro csomaggal. Feliratkozás.
403subscription_requiredA webes tanúsítványokhoz átalánydíjas előfizetés szükséges.
403insufficient_scopeAz API-kulcsból hiányzik a certificates:write hatókör.
413payload_too_largeA kérés törzse meghaladja a 64 KB-ot.
429quota_exceededA napi API-rögzítési keret elfogyott. Minden nap visszaáll.
429rate_limitedTúl sok kérés. Lásd a Retry-After fejlécet.
429service_busyA rögzítő szolgáltatás kapacitása betelt. Próbálja újra körülbelül 30 másodperc múlva.
502capture_failedA böngésző nem tudta betölteni az URL-t.
502certification_failedA rögzítés nem eredményezett használható bizonyítékot (pl. üres HAR).

GET /api/v1/certificates/:recordingId

Egy korábban létrehozott tanúsítvány metaadatainak lekérése.

Útvonal-paraméterek

ParaméterLeírás
recordingIdkötelezőA POST /api/v1/certificates által visszaadott recordingId.

Válasz 200 OK

MezőTípusLeírás
certificateIdstringEmber által olvasható tanúsítvány-azonosító.
recordingIdstringBelső felvétel-UUID.
typestringA felvétel típusa (pl. "webcapture").
statusstring"ready", ha a tanúsítvány elérhető.
urlstringA tanúsított URL.
createdAtstringISO 8601 szerinti létrehozási időbélyeg.
linksobjectA self és a certificate útvonal.

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

Az aláírt PDF-tanúsítvány letöltése. 302 Found választ ad — kövesse az átirányítást a fájl megkapásához. Használja a curl -L parancsot vagy a requests.get(..., allow_redirects=True) hívást.

Hitelesítés

Minden API-kérésnek tartalmaznia kell:

Authorization: Bearer ip_live_xxxxxxxxxxxxxxxx

A kulcsok itt hozhatók létre: Settings → Developer → API keys. A kulcs az Ön fiókjaként hitelesít — kezelje jelszóként. Kiszivárgás esetén azonnal vonja vissza.

A kulcsok előtagja éles fiókoknál ip_live_. Az előtag segít azonosítani őket a kódban vagy a környezeti fájlokban.

Sebességkorlátok & keretek

~30

Kérések percenként

30 kérés/perc tartósan (csúcs: 30). Túllépés esetén 429 rate_limited választ kap Retry-After fejléccel.

Napi

Napi rögzítési keret

A Pro csomag naponta meghatározott számú tanúsítvány-létrehozást biztosít. A keret minden nap visszaáll. Túllépés esetén 429 quota_exceeded választ kap.

64 KB

A kérés törzsének korlátja

A JSON kérés törzse nem haladhatja meg a 64 KB-ot. A gyakorlatban egy URL jóval ez alatt marad.

Kódpéldák

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

Gyakran ismételt kérdések

Mennyi ideig tart egy tanúsítvány létrehozása?

Általában 10–60 másodpercig, a céloldal betöltési idejétől függően. A POST kérés addig blokkol, amíg a tanúsítvány elkészül — nincs lekérdezési (polling) lépés.

Támogatja az API a fájltanúsítványokat (PDF, képfeltöltések)?

A jelenlegi API csak weboldalak (URL) tanúsítását támogatja. A fájlfeltöltés a webes felületen érhető el a secure.instantproof.legal/certificates/new címen.

Ellenőrizhetek egy API-n keresztül létrehozott tanúsítványt?

Igen. Az API által előállított PDF megegyezik a webes felületen létrehozottal. Húzza az instantproof.legal/certificate.html oldalra az Ed25519 aláírás és az RFC 3161 időbélyeg-lánc ellenőrzéséhez.

Mi történik, ha az URL nem érhető el?

A rögzítő szolgáltatás 502 capture_failed hibát ad vissza. A napi keretéből nem vonunk le.

Láthatók az API-val létrehozott tanúsítványok a webes irányítópulton?

Igen. Az API-n keresztül létrehozott minden tanúsítvány megjelenik a Tanúsítványok irányítópulton a Weboldal-tanúsítványaim alatt, a webes felületen létrehozottak mellett.