Richieste al minuto
30 richieste/minuto in modo continuativo (burst: 30). Il superamento restituisce 429 rate_limited con un'intestazione Retry-After.
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.
Salvi una pagina web, registri una sessione del browser o certifichi un file.
Un sigillo crittografico e una validazione temporale aiutano a rivelare modifiche successive.
Chiunque può controllare il pacchetto di prove in modo indipendente.
Inizi con 10 € di credito di benvenuto. Conservi un pacchetto di prove sigillato crittograficamente che può scaricare e verificare.
Tre passaggi da zero a un certificato PDF firmato.
Acceda, vada su Sviluppatori → Chiavi API e faccia clic su Crea chiave API. Copi la chiave — viene mostrata una sola volta.
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"
}
}
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.
URL di base: https://secure.instantproof.legal
Tutti gli endpoint restituiscono JSON. Autenticazione: Authorization: Bearer <key>.
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.
| Campo | Tipo | Descrizione | |
|---|---|---|---|
url | string | obbligatorio | Un URL https:// valido da certificare. Deve essere raggiungibile pubblicamente. |
| Campo | Tipo | Descrizione |
|---|---|---|
certificateId | string | ID del certificato leggibile (mostrato sul PDF). |
recordingId | string | UUID interno della registrazione. Da usare nelle chiamate API successive. |
url | string | L'URL che ha inviato. |
finalUrl | string | L'URL dopo eventuali reindirizzamenti, così come visto dal browser. |
status | string | "ready" — il certificato è disponibile immediatamente. |
links.self | string | Percorso per recuperare i metadati di questo certificato. |
links.certificate | string | Percorso per scaricare il PDF. Richiede l'autenticazione. |
| Stato | errore | Significato |
|---|---|---|
| 400 | invalid_url | Il campo url manca o non è un indirizzo https:// valido. |
| 400 | invalid_json | Il corpo della richiesta non è un JSON valido. |
| 401 | invalid_api_key | Intestazione Authorization mancante o non valida. |
| 402 | api_access_required | Il Suo account non ha il piano Pro. Abbonarsi. |
| 403 | subscription_required | I certificati web richiedono un abbonamento a tariffa fissa. |
| 403 | insufficient_scope | Alla chiave API manca lo scope certificates:write. |
| 413 | payload_too_large | Il corpo della richiesta supera i 64 KB. |
| 429 | quota_exceeded | Quota giornaliera di acquisizioni API raggiunta. Si azzera ogni giorno. |
| 429 | rate_limited | Troppe richieste. Vedere l'intestazione Retry-After. |
| 429 | service_busy | Servizio di acquisizione al limite della capacità. Riprovare dopo circa 30 secondi. |
| 502 | capture_failed | Il browser non è riuscito a caricare l'URL. |
| 502 | certification_failed | L'acquisizione non ha prodotto prove utilizzabili (ad es. HAR vuoto). |
Recupera i metadati di un certificato creato in precedenza.
| Parametro | Descrizione | |
|---|---|---|
recordingId | obbligatorio | Il recordingId restituito da POST /api/v1/certificates. |
| Campo | Tipo | Descrizione |
|---|---|---|
certificateId | string | ID del certificato leggibile. |
recordingId | string | UUID interno della registrazione. |
type | string | Tipo di registrazione (ad es. "webcapture"). |
status | string | "ready" non appena il certificato è disponibile. |
url | string | L'URL che è stato certificato. |
createdAt | string | Marca temporale di creazione ISO 8601. |
links | object | Percorsi self e certificate. |
Scarica il certificato PDF firmato. Restituisce 302 Found — segua il reindirizzamento per ricevere il file. Usi curl -L oppure requests.get(..., allow_redirects=True).
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.
30 richieste/minuto in modo continuativo (burst: 30). Il superamento restituisce 429 rate_limited con un'intestazione Retry-After.
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.
Il corpo della richiesta JSON non deve superare i 64 KB. In pratica un URL resta ben al di sotto di questo limite.
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
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 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.
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.
Il servizio di acquisizione restituisce un errore 502 capture_failed. La Sua quota giornaliera non viene consumata.
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.