veil

Rifiuta un accesso

Usa la richiesta e manda all'app error=access_denied, o login_required e consent_required per prompt=none.

POST/oidc/requests/{id}/deny
Accesso
Serve un codice privato
Client
Client locale o server

Parametri#

NomePosizioneSignificato
idObbligatorioPercorsoL'id della richiesta: 43 caratteri dall'indirizzo della pagina di consenso (`?req=`) o dal suo elemento meta.

Corpo JSON#

NomePosizioneSignificato
errorJSONaccess_denied (predefinito), login_required o consent_required.

Esempi di richiesta#

cURL
curl -fsS --json '{"error":"access_denied"}' "https://veil.rip/oidc/requests/$REQUEST_ID/deny"

Risposta#

HTTP 200application/json

{redirect}.

CampoTipoSignificato
redirectstringredirect_uri con error, error_description, state e iss.

Intestazioni della risposta#

IntestazioneValoreSignificato
Content-Typeapplication/jsonJSON, anche per gli errori.
Cache-Controlno-storePrivata: mai in una cache.

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

HTTPCodiceSignificato e cosa fare
400invalid_json

Il corpo non è un oggetto JSON, contiene chiavi duplicate o dati finali.

Invia un solo oggetto JSON valido con Content-Type application/json.

400invalid_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.

404not_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.

410request_expired

La richiesta di accesso è già stata usata o ha più di 30 minuti.

Torna all'app e ricomincia.

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.