Inserisci un codice di verifica
POST /fapi/v1/verifications/{verification_id}:attempt · chiamato dall'host di accesso dell'ambiente
Verifica il codice di 6 cifre ricevuto dall'utente dopo Invia un codice di verifica. Un codice giusto contrassegna l'indirizzo come verificato e consuma il codice; la risposta è 204. Un codice sbagliato consuma uno dei tentativi del codice. Un codice errato, scaduto, già usato o esaurito, un id sconosciuto e l'id di un altro utente danno tutti la stessa risposta 422 verification_invalid; in quel caso l'utente chiede un nuovo codice. Richiede il cookie __Host-idp_session dell'utente autenticato; se il cookie manca, è scaduto o è stato revocato, restituisce 401 unauthenticated. Un'app di prima parte su un altro origin può invece inviare il proprio token di accesso alla front API (Authorization: DPoP <token> con una prova DPoP; vedi Token di accesso alla front API).
Richiesta
Parametro di percorso:
| Parametro | Descrizione |
|---|---|
verification_id |
L'id della risposta di invio. |
Header:
| Header | Obbligatorio | Descrizione |
|---|---|---|
Idp-Client |
sì | Identificatore dell'SDK. |
Origin |
sì | Deve essere esattamente https://<host di accesso>. |
Content-Type |
sì | application/json. |
Body:
| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
code |
string | sì | Il codice di 6 cifre dall'email. |
Risposta
204 No Content; l'indirizzo è verificato.
Errori
| Stato | Codice | Quando |
|---|---|---|
| 400 | malformed_request |
Il corpo non è JSON valido. |
| 400 | unknown_field |
Il corpo ha un campo diverso da code. |
| 401 | unauthenticated |
Nessun cookie di sessione valido. |
| 403 | origin_not_allowed |
Origin manca o è errato. |
| 403 | test_feature_not_in_production |
Il codice è il codice di test fisso 424242 e l'ambiente è di produzione. Il tentativo viene consumato come un codice errato. |
| 413 | payload_too_large |
Il corpo è troppo grande. |
| 415 | unsupported_media_type |
Content-Type non è application/json. |
| 422 | validation_failed |
code manca. |
| 422 | verification_invalid |
Il codice è errato, scaduto, già usato o senza tentativi, oppure l'id è sconosciuto. |
Esempio
curl -X POST https://example.keenauth.app/fapi/v1/verifications/0190a5c4-1b2c-7d3e-8f40-5162738400ff:attempt \
-H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
-H "Origin: https://example.keenauth.app" \
-H "Content-Type: application/json" \
-b cookies.txt \
-d '{"code": "123456"}'