Sviluppatori · API REST

Automatizzi la certificazione di contenuti digitali tramite l'API

Catturi · Sigilli · Verifichi

L'API REST di InstantProof Le consente di certificare in modo programmatico qualsiasi URL pubblico. Si autentichi con una chiave API Bearer, invii un URL con POST e riceva un certificato PDF firmato con un pacchetto di prove completo — con la stessa marca temporale RFC 3161 e la stessa firma Ed25519 dell'interfaccia web.

Provi subito, senza account.La sua prima prova è gratuita · 10 € di credito di benvenuto alla conferma dell'e-mail · Nessuna carta richiestaOfferta di lancio. Il credito può essere usato anche per catture di pagine web o certificazione di file.
RESTJSON su HTTPS
BearerAutenticazione con chiave API
RFC 3161Validazioni temporali qualificate
Illustrazione della certificazione tramite API
  1. 01

    Catturi

    Salvi una pagina web, registri una sessione del browser o certifichi un file.

  2. 02

    Sigilli

    Un sigillo crittografico e una validazione temporale aiutano a rivelare modifiche successive.

  3. 03

    Verifichi

    Chiunque può controllare il pacchetto di prove in modo indipendente.

Prove digitali. Rese semplici.

Catturi ciò che conta. Prima che cambi.

Inizi con 10 € di credito di benvenuto. Conservi un pacchetto di prove sigillato crittograficamente che può scaricare e verificare.

Catturi la sua prima prova →

Prerequisiti

1
Piano Pro o superioreL'API richiede l'abbonamento Pro (funzionalità api_access). Abbonarsi qui.
2
Una chiave APILa crei in Impostazioni → Chiavi API. Copi subito la chiave — viene mostrata una sola volta.
3
Un URL https:// da certificareL'API certifica pagine web raggiungibili pubblicamente. L'URL deve essere un indirizzo https:// valido.

Avvio rapido

Tre passaggi da zero a un certificato PDF firmato.

Passaggio 1 — Creare una chiave API

Acceda, vada su Sviluppatori → Chiavi API e faccia clic su Crea chiave API. Copi la chiave — viene mostrata una sola volta.

Passaggio 2 — Creare un certificato

Invii una richiesta POST con il Suo URL:

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

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

Passaggio 3 — Scaricare il certificato PDF

Segua l'URL links.certificate con la Sua chiave API. Il server restituisce un reindirizzamento 302 verso un URL di download prefirmato:

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

Il PDF scaricato è lo stesso certificato PDF firmato prodotto dall'interfaccia web, verificabile su /certificate.html.

Riferimento API

URL di base: https://secure.instantproof.legal
Tutti gli endpoint restituiscono JSON. Autenticazione: Authorization: Bearer <key>.

POST /api/v1/certificates

Crea un nuovo certificato di sito web. La piattaforma acquisisce l'URL in un browser headless, produce un log di rete HAR e uno screenshot, firma il manifesto con Ed25519 e lo ancora a una marca temporale RFC 3161 qualificata. L'operazione richiede da 10 a 60 secondi.

Corpo della richiesta (JSON)

CampoTipoDescrizione
urlstringobbligatorioUn URL https:// valido da certificare. Deve essere raggiungibile pubblicamente.

Risposta 201 Created

CampoTipoDescrizione
certificateIdstringID del certificato leggibile (mostrato sul PDF).
recordingIdstringUUID interno della registrazione. Da usare nelle chiamate API successive.
urlstringL'URL che ha inviato.
finalUrlstringL'URL dopo eventuali reindirizzamenti, così come visto dal browser.
statusstring"ready" — il certificato è disponibile immediatamente.
links.selfstringPercorso per recuperare i metadati di questo certificato.
links.certificatestringPercorso per scaricare il PDF. Richiede l'autenticazione.

Risposte di errore

StatoerroreSignificato
400invalid_urlIl campo url manca o non è un indirizzo https:// valido.
400invalid_jsonIl corpo della richiesta non è un JSON valido.
401invalid_api_keyIntestazione Authorization mancante o non valida.
402api_access_requiredIl Suo account non ha il piano Pro. Abbonarsi.
403subscription_requiredI certificati web richiedono un abbonamento a tariffa fissa.
403insufficient_scopeAlla chiave API manca lo scope certificates:write.
413payload_too_largeIl corpo della richiesta supera i 64 KB.
429quota_exceededQuota giornaliera di acquisizioni API raggiunta. Si azzera ogni giorno.
429rate_limitedTroppe richieste. Vedere l'intestazione Retry-After.
429service_busyServizio di acquisizione al limite della capacità. Riprovare dopo circa 30 secondi.
502capture_failedIl browser non è riuscito a caricare l'URL.
502certification_failedL'acquisizione non ha prodotto prove utilizzabili (ad es. HAR vuoto).

GET /api/v1/certificates/:recordingId

Recupera i metadati di un certificato creato in precedenza.

Parametri del percorso

ParametroDescrizione
recordingIdobbligatorioIl recordingId restituito da POST /api/v1/certificates.

Risposta 200 OK

CampoTipoDescrizione
certificateIdstringID del certificato leggibile.
recordingIdstringUUID interno della registrazione.
typestringTipo di registrazione (ad es. "webcapture").
statusstring"ready" non appena il certificato è disponibile.
urlstringL'URL che è stato certificato.
createdAtstringMarca temporale di creazione ISO 8601.
linksobjectPercorsi self e certificate.

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

Scarica il certificato PDF firmato. Restituisce 302 Found — segua il reindirizzamento per ricevere il file. Usi curl -L oppure requests.get(..., allow_redirects=True).

Autenticazione

Tutte le richieste API devono includere:

Authorization: Bearer ip_live_xxxxxxxxxxxxxxxx

Le chiavi si creano in Impostazioni → Sviluppatori → Chiavi API. Una chiave autentica come il Suo account — la tratti come una password. In caso di fuga, la revochi immediatamente.

Le chiavi hanno il prefisso ip_live_ per gli account live. Il prefisso Le permette di riconoscerle nel codice o nei file di ambiente.

Limiti di frequenza & quote

~30

Richieste al minuto

30 richieste/minuto in modo continuativo (burst: 30). Il superamento restituisce 429 rate_limited con un'intestazione Retry-After.

Giornaliera

Quota giornaliera di acquisizioni

Il piano Pro prevede un numero fisso di creazioni di certificati al giorno. La quota si azzera ogni giorno. Il superamento restituisce 429 quota_exceeded.

64 KB

Limite del corpo della richiesta

Il corpo della richiesta JSON non deve superare i 64 KB. In pratica un URL resta ben al di sotto di questo limite.

Esempi di codice

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

Domande frequenti

Quanto tempo richiede la creazione di un certificato?

In genere da 10 a 60 secondi, a seconda del tempo di caricamento della pagina di destinazione. La richiesta POST resta in attesa finché il certificato non è pronto — non è previsto alcun passaggio di polling.

L'API supporta i certificati di file (PDF, caricamenti di immagini)?

L'API attuale supporta solo la certificazione di siti web (URL). Il caricamento di file è disponibile tramite l'interfaccia web all'indirizzo secure.instantproof.legal/certificates/new.

Posso verificare un certificato creato tramite l'API?

Sì. Il PDF prodotto dall'API è identico a quello creato tramite l'interfaccia web. Lo trascini su instantproof.legal/certificate.html per verificare la firma Ed25519 e la catena della marca temporale RFC 3161.

Che cosa succede se l'URL non è raggiungibile?

Il servizio di acquisizione restituisce un errore 502 capture_failed. La Sua quota giornaliera non viene consumata.

I certificati creati tramite l'API sono visibili nella dashboard web?

Sì. Ogni certificato creato tramite l'API compare nella Sua dashboard Certificati, alla voce I miei certificati di siti web, insieme agli eventuali certificati creati tramite l'interfaccia web.