Doğrulama kodu girin
POST /fapi/v1/verifications/{verification_id}:attempt · ortamın giriş ana makinesinden çağrılır
Kullanıcının Doğrulama kodu gönderin adımından sonra aldığı 6 haneli kodu kontrol eder. Doğru kod e-posta adresini doğrulanmış olarak işaretler ve kodu kullanılmış hale getirir; yanıt 204 olur. Yanlış kod, kodun denemelerinden birini tüketir. Yanlış, süresi dolmuş, kullanılmış veya denemeleri tükenmiş bir kod, bilinmeyen bir kimlik ve başka bir kullanıcının kimliği aynı 422 verification_invalid yanıtını verir; bu durumda kullanıcı yeni bir kod ister. Kimliği doğrulanmış kullanıcının __Host-idp_session çerezini gerektirir; çerez eksik, süresi dolmuş veya iptal edilmişse 401 unauthenticated döndürür. Farklı bir kökenteki birinci taraf bir uygulama bunun yerine ön yüz API erişim belirtecini (DPoP kanıtıyla birlikte Authorization: DPoP <token>; bkz. Ön yüz API erişim belirteci) gönderebilir.
İstek
Yol parametresi:
| Parametre | Açıklama |
|---|---|
verification_id |
Gönderme yanıtındaki id. |
Başlıklar:
| Başlık | Zorunlu | Açıklama |
|---|---|---|
Idp-Client |
evet | SDK tanımlayıcısı. |
Origin |
evet | Tam olarak https://<giriş ana makinesi> olmalıdır. |
Content-Type |
evet | application/json. |
Gövde:
| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
code |
string | evet | E-postadaki 6 haneli kod. |
Yanıt
204 No Content; adres doğrulanmıştır.
Hatalar
| Durum | Kod | Ne zaman |
|---|---|---|
| 400 | malformed_request |
Gövde geçerli bir JSON değil. |
| 400 | unknown_field |
Gövde, code dışında bir alan içeriyor. |
| 401 | unauthenticated |
Geçerli bir oturum çerezi yok. |
| 403 | origin_not_allowed |
Origin eksik veya hatalı. |
| 403 | test_feature_not_in_production |
Kod sabit test kodu 424242 ve ortam üretim. Deneme, yanlış kod gibi tüketilir. |
| 413 | payload_too_large |
Gövde çok büyük. |
| 415 | unsupported_media_type |
Content-Type application/json değil. |
| 422 | validation_failed |
code eksik. |
| 422 | verification_invalid |
Kod yanlış, süresi dolmuş, kullanılmış veya denemeleri tükenmiş ya da kimlik bilinmiyor. |
Örnek
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"}'