# 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](/docs/api/fapi/verifications/start) 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](/docs/api/fapi/front-api-token)) 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

```bash
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"}'
```