veil

Apri il link per fermare gli avvisi

La pagina a cui portano gli avvisi via email, per fermarli senza la chiave della scheda.

GET/notices/stop
Accesso
Accesso pubblico
Client
Client locale o server

Parametri#

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

Esempi di richiesta#

cURL
curl -fsS 'https://veil.rip/notices/stop'

Risposta#

HTTP 200text/html

Una pagina che legge il numero della scheda e il token dopo il #, chiede prima, e solo al pulsante li manda con un POST a /v1/notices/unsubscribe.

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#

  • Le email portano a /notices/stop#n=<scheda>&t=<token>. Aprire la pagina non cambia niente, perché i programmi di posta aprono i link da soli.

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.