Za programere · REST API

Automatizirajte certificiranje digitalnog sadržaja putem API-ja

Pohranite · Zapečatite · Provjerite

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.

Isprobajte odmah, bez računa.Vaš prvi dokaz je besplatan · 10 € dobrodošlična kredita nakon potvrde e-pošte · Kartica nije potrebnaUvodna ponuda. Kredit možete iskoristiti i za pohranu web-stranica ili certificiranje datoteka.
RESTJSON preko HTTPS-a
BearerAutentifikacija API ključem
RFC 3161Kvalificirani vremenski žigovi
Ilustracija certificiranja putem API-ja
  1. 01

    Pohranite

    Spremite web-stranicu, snimite sesiju preglednika ili certificirajte datoteku.

  2. 02

    Zapečatite

    Kriptografski pečat i vremenski žig pomažu otkriti naknadne izmjene.

  3. 03

    Provjerite

    Svatko može neovisno provjeriti paket dokaza.

Digitalni dokazi. Jednostavno.

Pohranite ono što je važno. Prije nego što se promijeni.

Počnite s 10 € dobrodošlična kredita. Zadržite kriptografski zapečaćen paket dokaza koji možete preuzeti i provjeriti.

Prikupite svoj prvi dokaz →

Preduvjeti

1
Plan Pro ili višiAPI zahtijeva pretplatu Pro (značajka api_access). Pretplatite se ovdje.
2
API ključIzradite ga na Postavke → API ključevi. Ključ odmah kopirajte — prikazuje se samo jednom.
3
https:// URL za certificiranjeAPI certificira javno dostupne web-stranice. URL mora biti valjana https:// adresa.

Brzi početak

Tri koraka od nule do potpisanog PDF certifikata.

Korak 1 — Izradite API ključ

Prijavite se, otvorite Za programere → API ključevi i kliknite Izradi API ključ. Kopirajte ključ — prikazuje se samo jednom.

Korak 2 — Izradite certifikat

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

Korak 3 — Preuzmite PDF certifikata

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.

API referenca

Osnovni URL: https://secure.instantproof.legal
Svi endpointi vraćaju JSON. Autentifikacija: Authorization: Bearer <key>.

POST /api/v1/certificates

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.

Tijelo zahtjeva (JSON)

PoljeTipOpis
urlstringobaveznoValjan https:// URL za certificiranje. Mora biti javno dostupan.

Odgovor 201 Created

PoljeTipOpis
certificateIdstringČitljiva oznaka certifikata (prikazana na PDF-u).
recordingIdstringInterni UUID snimke. Koristite ga u sljedećim API pozivima.
urlstringURL koji ste poslali.
finalUrlstringURL nakon eventualnih preusmjeravanja, kako ga vidi preglednik.
statusstring"ready" — certifikat je odmah dostupan.
links.selfstringPutanja za dohvat metapodataka ovog certifikata.
links.certificatestringPutanja za preuzimanje PDF-a. Zahtijeva autentifikaciju.

Odgovori s pogreškom

StatuserrorZnačenje
400invalid_urlPolje url nedostaje ili nije valjana https:// adresa.
400invalid_jsonTijelo zahtjeva nije valjan JSON.
401invalid_api_keyZaglavlje Authorization nedostaje ili nije valjano.
402api_access_requiredVaš račun nema plan Pro. Pretplatite se.
403subscription_requiredCertifikati web-stranica zahtijevaju pretplatu s paušalnom naknadom.
403insufficient_scopeAPI ključ nema ovlast certificates:write.
413payload_too_largeTijelo zahtjeva premašuje 64 KB.
429quota_exceededDosegnuta je dnevna API kvota za bilježenje. Obnavlja se svaki dan.
429rate_limitedPreviše zahtjeva. Pogledajte zaglavlje Retry-After.
429service_busyUsluga bilježenja je na granici kapaciteta. Pokušajte ponovno nakon ~30 sekundi.
502capture_failedPreglednik nije mogao učitati URL.
502certification_failedBilježenje nije proizvelo upotrebljive dokaze (npr. prazan HAR).

GET /api/v1/certificates/:recordingId

Dohvatite metapodatke certifikata koji ste prethodno izradili.

Parametri putanje

ParametarOpis
recordingIdobaveznorecordingId koji vraća POST /api/v1/certificates.

Odgovor 200 OK

PoljeTipOpis
certificateIdstringČitljiva oznaka certifikata.
recordingIdstringInterni UUID snimke.
typestringVrsta snimke (npr. "webcapture").
statusstring"ready" kada je certifikat dostupan.
urlstringURL koji je certificiran.
createdAtstringVremenski žig izrade u formatu ISO 8601.
linksobjectPutanje self i certificate.

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

Preuzmite potpisani PDF certifikata. Vraća 302 Found — slijedite preusmjeravanje kako biste dobili datoteku. Koristite curl -L ili requests.get(..., allow_redirects=True).

Autentifikacija

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.

Ograničenja brzine & kvote

~30

Zahtjeva u minuti

30 zahtjeva u minuti trajno (nalet: 30). Prekoračenje vraća 429 rate_limited sa zaglavljem Retry-After.

Dnevno

Dnevna kvota bilježenja

Plan Pro daje fiksan broj izrada certifikata dnevno. Kvota se obnavlja svaki dan. Prekoračenje vraća 429 quota_exceeded.

64 KB

Ograničenje tijela zahtjeva

JSON tijelo zahtjeva ne smije premašiti 64 KB. U praksi je URL daleko ispod tog ograničenja.

Primjeri koda

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

Često postavljana pitanja

Koliko traje izrada certifikata?

Obično 10–60 sekundi, ovisno o vremenu učitavanja ciljne stranice. POST zahtjev ostaje otvoren dok certifikat nije spreman — nema koraka ispitivanja (pollinga).

Podržava li API certifikate za datoteke (PDF, učitane slike)?

Trenutni API podržava samo certificiranje web-stranica (URL). Učitavanje datoteka dostupno je putem web-sučelja na secure.instantproof.legal/certificates/new.

Mogu li provjeriti certifikat izrađen putem API-ja?

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.

Što se događa ako URL nije dostupan?

Usluga bilježenja vraća pogrešku 502 capture_failed. Vaša dnevna kvota se ne troši.

Jesu li certifikati izrađeni putem API-ja vidljivi na web-nadzornoj ploč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.