Ritorna da un provider OAuth

Ricevi il ritorno dall’app Discord o GitHub configurata su Veil.

GET/v1/links/callback/{platform}

Accesso: Callback del provider OAuth
Client: Client locale o server

Parametri#

Nome	Posizione	Significato
`platform`Obbligatorio	Percorso	discord o github, scelto all’inizio del flusso.
`code, state`	Query	Parametri forniti dal provider OAuth. Mantienili privati.

Esempi di richiesta#

cURL

curl -fsS 'https://veil.rip/v1/links/callback/github'

Risposta#

HTTP 200text/html

Una pagina di ritorno che completa il flusso nel browser che lo ha iniziato. La sola callback non pubblica un collegamento.

Intestazioni della risposta#

Intestazione	Valore	Significato
`Content-Type`	`text/html`	Usa il tipo dichiarato per scegliere come leggere il corpo.
`Date`	`HTTP date`	Ora del server. Confrontala con il tuo orologio per firmare le richieste.
`Cache-Control`	`no-store`	Non conservare le risposte private o temporanee in una cache condivisa.
`Retry-After`	`integer seconds, on rate_limited or busy`	Attendi almeno questo intervallo prima di riprovare. Altri codici 429/503 non lo includono necessariamente.

Errori#

Il callback OAuth mostra una pagina HTML di ritorno, anche in caso di errore. I codici seguenti descrivono l’errore mostrato nella pagina. Guida a risposte ed errori

HTTP	Codice	Significato e cosa fare
400	`invalid_parameter`	Un campo del percorso, della query o del corpo manca, è malformato o fuori intervallo. Correggi il campo indicato in `error.message` prima di inviare di nuovo.
404	`not_found`	La scheda, la chiave, l’alias, il codice o la risorsa richiesti non sono stati trovati. Controlla l’identificatore. Codici e anteprime temporanei potrebbero essere scaduti o già usati.
409	`callback_used`	Questo accesso OAuth è già tornato una volta. Riprendi il flusso nel browser originale o avvia una nuova sessione di collegamento.
410	`proof_expired`	La sessione temporanea di prova dell’account è scaduta. Avvia una nuova sessione di collegamento.
422	`proof_failed`	Il provider, il codice o la prova pubblicata non hanno superato la verifica. Leggi `error.message`, correggi la prova e riprova mentre la sessione è valida.
503	`provider_not_configured`	Il provider di prova scelto non è disponibile su questo server. Leggi /v1/platforms per i metodi disponibili.

Errori comuni delle richieste

HTTP Codice Significato e cosa fare

429

HTTP	Codice	Significato e cosa fare
429	`rate_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.
500	`internal_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.
503	`busy`	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.

rate_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.

500

internal_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.

503

busy

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.

Leggi questa voce in JSON