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.
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.
Mentsen el egy weboldalt, rögzítsen egy böngészőmunkamenetet, vagy tanúsítson egy fájlt.
A kriptográfiai pecsét és az időbélyeg segít felfedni a későbbi módosításokat.
A bizonyítékcsomagot bárki függetlenül ellenőrizheti.
Kezdje 10 € üdvözlő kredittel. Őrizzen meg egy kriptográfiailag lepecsételt bizonyítékcsomagot, amelyet letölthet és ellenőrizhet.
Három lépés a nulláról az aláírt PDF-tanúsítványig.
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.
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"
}
}
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ő.
Alap-URL: https://secure.instantproof.legal
Minden végpont JSON-t ad vissza. Hitelesítés: Authorization: Bearer <key>.
Ú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.
| Mező | Típus | Leírás | |
|---|---|---|---|
url | string | kötelező | A tanúsítandó érvényes https:// URL. Nyilvánosan elérhetőnek kell lennie. |
| Mező | Típus | Leírás |
|---|---|---|
certificateId | string | Ember által olvasható tanúsítvány-azonosító (a PDF-en látható). |
recordingId | string | Belső felvétel-UUID. A későbbi API-hívásokban használja. |
url | string | Az Ön által beküldött URL. |
finalUrl | string | Az URL az esetleges átirányítások után, ahogyan a böngésző látta. |
status | string | "ready" — a tanúsítvány azonnal elérhető. |
links.self | string | A tanúsítvány metaadatainak lekérési útvonala. |
links.certificate | string | A PDF letöltési útvonala. Hitelesítés szükséges. |
| Állapot | error | Jelentés |
|---|---|---|
| 400 | invalid_url | Az url mező hiányzik, vagy nem érvényes https:// cím. |
| 400 | invalid_json | A kérés törzse nem érvényes JSON. |
| 401 | invalid_api_key | Hiányzó vagy érvénytelen Authorization fejléc. |
| 402 | api_access_required | Fiókja nem rendelkezik Pro csomaggal. Feliratkozás. |
| 403 | subscription_required | A webes tanúsítványokhoz átalánydíjas előfizetés szükséges. |
| 403 | insufficient_scope | Az API-kulcsból hiányzik a certificates:write hatókör. |
| 413 | payload_too_large | A kérés törzse meghaladja a 64 KB-ot. |
| 429 | quota_exceeded | A napi API-rögzítési keret elfogyott. Minden nap visszaáll. |
| 429 | rate_limited | Túl sok kérés. Lásd a Retry-After fejlécet. |
| 429 | service_busy | A rögzítő szolgáltatás kapacitása betelt. Próbálja újra körülbelül 30 másodperc múlva. |
| 502 | capture_failed | A böngésző nem tudta betölteni az URL-t. |
| 502 | certification_failed | A rögzítés nem eredményezett használható bizonyítékot (pl. üres HAR). |
Egy korábban létrehozott tanúsítvány metaadatainak lekérése.
| Paraméter | Leírás | |
|---|---|---|
recordingId | kötelező | A POST /api/v1/certificates által visszaadott recordingId. |
| Mező | Típus | Leírás |
|---|---|---|
certificateId | string | Ember által olvasható tanúsítvány-azonosító. |
recordingId | string | Belső felvétel-UUID. |
type | string | A felvétel típusa (pl. "webcapture"). |
status | string | "ready", ha a tanúsítvány elérhető. |
url | string | A tanúsított URL. |
createdAt | string | ISO 8601 szerinti létrehozási időbélyeg. |
links | object | A self és a certificate útvonal. |
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.
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.
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.
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.
A JSON kérés törzse nem haladhatja meg a 64 KB-ot. A gyakorlatban egy URL jóval ez alatt marad.
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
Á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.
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.
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.
A rögzítő szolgáltatás 502 capture_failed hibát ad vissza. A napi keretéből nem vonunk le.
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.