veil

Apri il generatore di frammenti

Copia il link, il badge o il widget di una scheda con l’anteprima.

GET/embed
Accesso
Accesso pubblico
Client
Incorpora in un riquadro

Parametri#

NomePosizioneSignificato
nQueryNumero permanente della scheda, facoltativo.
langQueryen oppure it. La lingua predefinita è l’inglese.

Esempi di richiesta#

cURL
curl -fsS 'https://veil.rip/embed?n=2'

Risposta#

HTTP 200text/html

Una pagina per scegliere numero della scheda, tema e lingua, con frammenti da copiare.

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.

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.