veil

Apri la verifica nel browser

Apri il controllo di un messaggio nel browser del lettore.

GET/verify
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/verify'

Un frammento può contenere b con il blocco firma completo in base64url, oppure u, m e s insieme. u è il numero della scheda; m è il base64url dei byte UTF-8 del messaggio; s è il base64url dei byte della firma. Ometti il padding base64.

text
https://veil.rip/verify#b=BASE64URL_BLOCK
https://veil.rip/verify#u=1&m=BASE64URL_MESSAGE&s=BASE64URL_SIGNATURE

Risposta#

HTTP 200text/html

Una pagina che accetta blocchi firma incollati e link con frammento. I dati dopo # non vengono mandati al server.

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#

  • I controlli di condivisione della pagina producono i link con frammento supportati. Un messaggio mandato all’API o a un URL /v/ raggiunge il server.

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.