veil

Apri il warrant canary

Controlla la firma del warrant canary nel browser di chi legge.

GET/canary
Accesso
Accesso pubblico
Client
Apri come pagina

Parametri#

NomePosizioneSignificato
langQueryen oppure it. La lingua predefinita è l’inglese.

Esempi di richiesta#

cURL
curl -fsS 'https://veil.rip/canary'

Risposta#

HTTP 200text/html

Una pagina che legge GET /v1/canary e controlla l’ultima dichiarazione nel browser: il testo, la data, la chiave e la scheda di chi firma, il registro e i suoi testimoni.

Intestazioni della risposta#

IntestazioneValoreSignificato
Content-Typetext/htmlUsa il tipo dichiarato per scegliere come leggere il corpo.
DateHTTP dateOra del server. Confrontala con il tuo orologio per firmare le richieste.
Retry-Afterinteger seconds, on rate_limited or busyAttendi almeno questo intervallo prima di riprovare. Altri codici 429/503 non lo includono necessariamente.

Note d’uso#

  • Ogni pagina di Veil porta qui dal suo piede, con la data dell’ultima dichiarazione, o un avviso quando è vecchia o manca.

Errori#

Gli errori API restituiscono un oggetto error. Usa error.code nella logica del programma; error.message è un testo inglese per le persone e può cambiare. Guida a risposte ed errori

Errori comuni delle richieste
HTTPCodiceSignificato e cosa fare
429rate_limited

È stato superato un limite anonimo, delle richieste firmate o della chiave API.

Attendi almeno i secondi indicati da Retry-After. Condividi coda e budget dei tentativi tra i tuoi processi.

500internal_error

Si è verificato un errore imprevisto del server. I dettagli interni non vengono restituiti.

Riprova le letture con attese crescenti e un limite. Controlla l’esito delle scritture prima di inviare una nuova operazione firmata.

503busy

L’applicazione ha raggiunto un limite temporaneo di concorrenza o del database.

Attendi i secondi indicati da Retry-After e riprova con attese crescenti e un limite.