Razvijalci · REST API

Avtomatizirajte potrjevanje digitalne vsebine prek API-ja

Zajemite · Opečatite · Preverite

REST API InstantProof Vam omogoča programsko potrjevanje katerega koli javnega URL-ja. Overite se s ključem API (Bearer), pošljite POST z URL-jem in prejmite podpisano potrdilo PDF s celotnim paketom dokazov — z istim časovnim žigom RFC 3161 in podpisom Ed25519 kot v spletnem vmesniku.

Preizkusite zdaj, račun ni potreben.Vaš prvi dokaz je brezplačen · 10 € pozdravnega kredita ob potrditvi e-pošte · Kartica ni potrebnaUvajalna ponudba. Kredit lahko porabite tudi za zajeme spletnih strani ali potrjevanje datotek.
RESTJSON prek HTTPS
BearerOverjanje s ključem API
RFC 3161Kvalificirani časovni žigi
Ilustracija potrjevanja prek API-ja
  1. 01

    Zajemite

    Shranite spletno stran, posnemite sejo brskalnika ali potrdite datoteko.

  2. 02

    Opečatite

    Kriptografski žig in časovni žig pomagata razkriti poznejše spremembe.

  3. 03

    Preverite

    Dokazni paket lahko neodvisno preveri kdorkoli.

Digitalni dokazi. Brez zapletov.

Zajemite, kar šteje. Preden se spremeni.

Začnite z 10 € pozdravnega kredita. Obdržite kriptografsko opečaten dokazni paket, ki ga lahko prenesete in preverite.

Zajemite svoj prvi dokaz →

Predpogoji

1
Paket Pro ali višjiAPI zahteva naročnino Pro (funkcija api_access). Naročite se tukaj.
2
Ključ APIUstvarite ga v Nastavitve → Ključi API. Ključ takoj kopirajte — prikazan je samo enkrat.
3
URL https://, ki ga želite potrditiAPI potrjuje javno dosegljive spletne strani. URL mora biti veljaven naslov https://.

Hitri začetek

Trije koraki od nič do podpisanega potrdila PDF.

1. korak — ustvarite ključ API

Prijavite se, odprite Razvijalci → Ključi API in kliknite Ustvari ključ API. Ključ kopirajte — prikazan je samo enkrat.

2. korak — ustvarite potrdilo

Pošljite zahtevo POST s svojim URL-jem:

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

3. korak — prenesite potrdilo PDF

S svojim ključem API odprite URL links.certificate. Strežnik vrne preusmeritev 302 na vnaprej podpisan URL za prenos:

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

Preneseni PDF je enako podpisano potrdilo PDF, kot ga ustvari spletni vmesnik, in ga je mogoče preveriti na /certificate.html.

Referenca API

Osnovni URL: https://secure.instantproof.legal
Vse končne točke vračajo JSON. Overjanje: Authorization: Bearer <key>.

POST /api/v1/certificates

Ustvari novo potrdilo za spletno mesto. Platforma zajame URL v brskalniku brez grafičnega vmesnika, ustvari omrežni dnevnik HAR in posnetek zaslona, podpiše manifest z Ed25519 in ga zasidra v kvalificiran časovni žig RFC 3161. Postopek traja 10–60 sekund.

Telo zahteve (JSON)

PoljeTipOpis
urlstringobveznoVeljaven URL https://, ki ga želite potrditi. Mora biti javno dosegljiv.

Odgovor 201 Created

PoljeTipOpis
certificateIdstringČloveku berljiva oznaka potrdila (prikazana na PDF).
recordingIdstringNotranji UUID posnetka. Uporabite ga v nadaljnjih klicih API.
urlstringURL, ki ste ga poslali.
finalUrlstringURL po morebitnih preusmeritvah, kot ga vidi brskalnik.
statusstring"ready" — potrdilo je takoj na voljo.
links.selfstringPot za pridobitev metapodatkov tega potrdila.
links.certificatestringPot za prenos PDF. Zahteva overitev.

Odgovori z napako

StanjenapakaPomen
400invalid_urlPolje url manjka ali ni veljaven naslov https://.
400invalid_jsonTelo zahteve ni veljaven JSON.
401invalid_api_keyGlava Authorization manjka ali je neveljavna.
402api_access_requiredVaš račun nima paketa Pro. Naročite se.
403subscription_requiredSpletna potrdila zahtevajo naročnino s pavšalno ceno.
403insufficient_scopeKljuč API nima obsega certificates:write.
413payload_too_largeTelo zahteve presega 64 KB.
429quota_exceededDnevna kvota zajemov prek API je dosežena. Ponastavi se vsak dan.
429rate_limitedPreveč zahtev. Glejte glavo Retry-After.
429service_busyStoritev zajema je zasedena. Poskusite znova čez približno 30 sekund.
502capture_failedBrskalnik ni mogel naložiti URL-ja.
502certification_failedZajem ni ustvaril uporabnih dokazov (npr. prazen HAR).

GET /api/v1/certificates/:recordingId

Pridobi metapodatke potrdila, ki ste ga predhodno ustvarili.

Parametri poti

ParameterOpis
recordingIdobveznorecordingId, ki ga vrne POST /api/v1/certificates.

Odgovor 200 OK

PoljeTipOpis
certificateIdstringČloveku berljiva oznaka potrdila.
recordingIdstringNotranji UUID posnetka.
typestringVrsta posnetka (npr. "webcapture").
statusstring"ready", ko je potrdilo na voljo.
urlstringURL, ki je bil potrjen.
createdAtstringČasovni žig ustvaritve ISO 8601.
linksobjectPoti self in certificate.

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

Prenesite podpisano potrdilo PDF. Vrne 302 Found — sledite preusmeritvi, da prejmete datoteko. Uporabite curl -L ali requests.get(..., allow_redirects=True).

Overjanje

Vse zahteve API morajo vsebovati:

Authorization: Bearer ip_live_xxxxxxxxxxxxxxxx

Ključi se ustvarijo v Nastavitve → Razvijalci → Ključi API. Ključ se overja kot Vaš račun — ravnajte z njim kot z geslom. Če uide v javnost, ga takoj prekličite.

Ključi imajo za žive račune predpono ip_live_. Predpona Vam pomaga prepoznati jih v kodi ali okoljskih datotekah.

Omejitve hitrosti in kvote

~30

Zahteve na minuto

30 zahtev na minuto neprekinjeno (špica: 30). Pri preseganju se vrne 429 rate_limited z glavo Retry-After.

Dnevno

Dnevna kvota zajemov

Paket Pro omogoča fiksno število izdanih potrdil na dan. Kvota se ponastavi vsak dan. Pri preseganju se vrne 429 quota_exceeded.

64 KB

Omejitev telesa zahteve

Telo zahteve JSON ne sme presegati 64 KB. V praksi je URL precej pod to omejitvijo.

Primeri kode

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

Lupina (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

Pogosta vprašanja

Kako dolgo traja izdaja potrdila?

Običajno 10–60 sekund, odvisno od časa nalaganja ciljne strani. Zahteva POST počaka, dokler potrdilo ni pripravljeno — koraka poizvedovanja ni.

Ali API podpira potrdila za datoteke (PDF, naložene slike)?

Trenutni API podpira samo potrjevanje spletnih mest (URL). Nalaganje datotek je na voljo prek spletnega vmesnika na secure.instantproof.legal/certificates/new.

Ali lahko preverim potrdilo, ustvarjeno prek API-ja?

Da. PDF, ki ga ustvari API, je enak tistemu, ustvarjenemu prek spletnega vmesnika. Povlecite ga na instantproof.legal/certificate.html, da preverite podpis Ed25519 in verigo časovnega žiga RFC 3161.

Kaj se zgodi, če URL ni dosegljiv?

Storitev zajema vrne napako 502 capture_failed. Vaša dnevna kvota se ne porabi.

Ali so potrdila, ustvarjena prek API-ja, vidna v spletni nadzorni plošči?

Da. Vsako potrdilo, ustvarjeno prek API-ja, se prikaže v Vaši nadzorni plošči Potrdila pod Moja potrdila za spletna mesta, skupaj z morebitnimi potrdili, ustvarjenimi prek spletnega vmesnika.