Leggi lo stato privato di una prova
Riprendi una prova con il suo token state segreto.
/v1/links/{state}- Accesso
- Serve un codice privato
- Client
- Client locale o server
Parametri#
| Nome | Posizione | Significato |
|---|---|---|
stateObbligatorio | Percorso | Lo stato privato di 64 caratteri esadecimali restituito da start. |
Esempi di richiesta#
curl -fsS 'https://veil.rip/v1/links/PROOF_STATE'Risposta#
La sfida o il permesso verificato, la scadenza e le informazioni di subentro. Tratta risposta e state come privati.
| Campo | Tipo | Significato |
|---|---|---|
state | string | Stato privato della sessione di prova. |
identity | integer | Numero della scheda destinataria. |
platform | string | Identificatore della piattaforma. |
method | string | Metodo di prova. |
status | string | pending, returned, verified, used o expired. |
expiresAt | string | Scadenza della sessione. |
subject | string | null | Identificatore normalizzato dell’account verificato. |
display | string | null | Nome visualizzato verificato. |
grant | string | null | Grant firmato monouso dopo la verifica, finché viene usato. |
grantExpiresAt | string | null | Scadenza del grant. |
challenge | string | null | Istruzioni pubbliche della prova. |
claimed | string | null | Account richiesto all’inizio, per i metodi che lo richiedono. |
holder | integer | null | Scheda attualmente titolare dell’account verificato. |
waitDays | integer | null | Periodo di annullamento del subentro se un’altra scheda ne è titolare. |
takeoverOpen | boolean | null | Indica se un subentro è già aperto. |
Intestazioni della risposta#
| Intestazione | Valore | Significato |
|---|---|---|
Content-Type | application/json | 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#
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
| 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 |
| 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. |
Errori comuni delle richieste
| 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 |
| 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 |