Zahtjeva u minuti
30 zahtjeva u minuti trajno (nalet: 30). Prekoračenje vraća 429 rate_limited sa zaglavljem Retry-After.
REST API InstantProof omogućuje programsko certificiranje bilo kojeg javnog URL-a. Autentificirajte se Bearer API ključem, pošaljite URL (POST) i primite potpisani PDF certifikat s cjelovitim paketom dokaza — isti RFC 3161 vremenski žig i Ed25519 potpis kao u web-sučelju.
Spremite web-stranicu, snimite sesiju preglednika ili certificirajte datoteku.
Kriptografski pečat i vremenski žig pomažu otkriti naknadne izmjene.
Svatko može neovisno provjeriti paket dokaza.
Počnite s 10 € dobrodošlična kredita. Zadržite kriptografski zapečaćen paket dokaza koji možete preuzeti i provjeriti.
Tri koraka od nule do potpisanog PDF certifikata.
Prijavite se, otvorite Za programere → API ključevi i kliknite Izradi API ključ. Kopirajte ključ — prikazuje se samo jednom.
Pošaljite POST zahtjev sa svojim URL-om:
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"}'
Odgovor 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"
}
}
Slijedite URL links.certificate sa svojim API ključem. Poslužitelj vraća preusmjeravanje 302 na unaprijed potpisani URL za preuzimanje:
curl -L \
-H "Authorization: Bearer ip_live_xxxxxxxxxxxxxxxx" \
"https://secure.instantproof.legal/api/v1/certificates/def456…/download" \
-o certificate.pdf
Preuzeti PDF isti je potpisani PDF certifikat koji proizvodi web-sučelje, a može se provjeriti na /certificate.html.
Osnovni URL: https://secure.instantproof.legal
Svi endpointi vraćaju JSON. Autentifikacija: Authorization: Bearer <key>.
Izradite novi certifikat web-stranice. Platforma otvara URL u headless pregledniku, izrađuje HAR mrežni zapisnik i snimku zaslona, potpisuje manifest algoritmom Ed25519 i sidri ga u kvalificirani RFC 3161 vremenski žig. Postupak traje 10–60 sekundi.
| Polje | Tip | Opis | |
|---|---|---|---|
url | string | obavezno | Valjan https:// URL za certificiranje. Mora biti javno dostupan. |
| Polje | Tip | Opis |
|---|---|---|
certificateId | string | Čitljiva oznaka certifikata (prikazana na PDF-u). |
recordingId | string | Interni UUID snimke. Koristite ga u sljedećim API pozivima. |
url | string | URL koji ste poslali. |
finalUrl | string | URL nakon eventualnih preusmjeravanja, kako ga vidi preglednik. |
status | string | "ready" — certifikat je odmah dostupan. |
links.self | string | Putanja za dohvat metapodataka ovog certifikata. |
links.certificate | string | Putanja za preuzimanje PDF-a. Zahtijeva autentifikaciju. |
| Status | error | Značenje |
|---|---|---|
| 400 | invalid_url | Polje url nedostaje ili nije valjana https:// adresa. |
| 400 | invalid_json | Tijelo zahtjeva nije valjan JSON. |
| 401 | invalid_api_key | Zaglavlje Authorization nedostaje ili nije valjano. |
| 402 | api_access_required | Vaš račun nema plan Pro. Pretplatite se. |
| 403 | subscription_required | Certifikati web-stranica zahtijevaju pretplatu s paušalnom naknadom. |
| 403 | insufficient_scope | API ključ nema ovlast certificates:write. |
| 413 | payload_too_large | Tijelo zahtjeva premašuje 64 KB. |
| 429 | quota_exceeded | Dosegnuta je dnevna API kvota za bilježenje. Obnavlja se svaki dan. |
| 429 | rate_limited | Previše zahtjeva. Pogledajte zaglavlje Retry-After. |
| 429 | service_busy | Usluga bilježenja je na granici kapaciteta. Pokušajte ponovno nakon ~30 sekundi. |
| 502 | capture_failed | Preglednik nije mogao učitati URL. |
| 502 | certification_failed | Bilježenje nije proizvelo upotrebljive dokaze (npr. prazan HAR). |
Dohvatite metapodatke certifikata koji ste prethodno izradili.
| Parametar | Opis | |
|---|---|---|
recordingId | obavezno | recordingId koji vraća POST /api/v1/certificates. |
| Polje | Tip | Opis |
|---|---|---|
certificateId | string | Čitljiva oznaka certifikata. |
recordingId | string | Interni UUID snimke. |
type | string | Vrsta snimke (npr. "webcapture"). |
status | string | "ready" kada je certifikat dostupan. |
url | string | URL koji je certificiran. |
createdAt | string | Vremenski žig izrade u formatu ISO 8601. |
links | object | Putanje self i certificate. |
Preuzmite potpisani PDF certifikata. Vraća 302 Found — slijedite preusmjeravanje kako biste dobili datoteku. Koristite curl -L ili requests.get(..., allow_redirects=True).
Svi API zahtjevi moraju sadržavati:
Authorization: Bearer ip_live_xxxxxxxxxxxxxxxx
Ključevi se izrađuju na Postavke → Za programere → API ključevi. Ključ se autentificira kao Vaš račun — postupajte s njim kao s lozinkom. Ako procuri, odmah ga opozovite.
Ključevi za aktivne račune imaju prefiks ip_live_. Prefiks Vam pomaže prepoznati ih u kodu ili datotekama okruženja.
30 zahtjeva u minuti trajno (nalet: 30). Prekoračenje vraća 429 rate_limited sa zaglavljem Retry-After.
Plan Pro daje fiksan broj izrada certifikata dnevno. Kvota se obnavlja svaki dan. Prekoračenje vraća 429 quota_exceeded.
JSON tijelo zahtjeva ne smije premašiti 64 KB. U praksi je URL daleko ispod tog ograničenja.
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
Obično 10–60 sekundi, ovisno o vremenu učitavanja ciljne stranice. POST zahtjev ostaje otvoren dok certifikat nije spreman — nema koraka ispitivanja (pollinga).
Trenutni API podržava samo certificiranje web-stranica (URL). Učitavanje datoteka dostupno je putem web-sučelja na secure.instantproof.legal/certificates/new.
Da. PDF koji proizvede API identičan je onom izrađenom putem web-sučelja. Povucite ga na instantproof.legal/certificate.html kako biste provjerili Ed25519 potpis i lanac RFC 3161 vremenskog žiga.
Usluga bilježenja vraća pogrešku 502 capture_failed. Vaša dnevna kvota se ne troši.
Da. Svaki certifikat izrađen putem API-ja pojavljuje se na Vašoj nadzornoj ploči Certifikati pod Moji certifikati web-stranica, zajedno s certifikatima izrađenima putem web-sučelja.