> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Hata Başvuru Kılavuzu

> Living Security /v1 genel API'sinin döndürebileceği tüm hatalar; kararlı makine kodları, HTTP durumları ve çözüm yolları.

Her `/v1` hata yanıtı, sabit bir alan kümesine sahip `application/problem+json` ([RFC 9457](https://www.rfc-editor.org/rfc/rfc9457)) biçimindedir:

```json theme={null}
{
  "type": "https://docs.livingsecurity.com/developers/v1/errors/resource_not_found",
  "title": "Not Found",
  "status": 404,
  "detail": "No such organization.",
  "code": "resource_not_found",
  "request_id": "req_...",
  "doc_url": "https://docs.livingsecurity.com/developers/v1/errors/resource_not_found",
  "retryable": false
}
```

Mantığınızı `code` üzerine kurun, `detail` üzerine kurmayın — `code` kararlı bir makine sözleşmesidir; `detail` ise insan tarafından okunabilir niteliktedir ve değişebilir. `param`, hata belirli bir istek parametresine atfedilebildiğinde bulunur. Destek ekibiyle iletişime geçerken `request_id` bilgisini ekleyin.

## Hata kodları

| Kod | HTTP durumu | Yeniden denenebilir |
| - | - | - |
| [`unauthorized`](/tr/developers/v1/errors/unauthorized) | 401 | Hayır |
| [`credential_inactive`](/tr/developers/v1/errors/credential_inactive) | 401 | Hayır |
| [`credential_expired`](/tr/developers/v1/errors/credential_expired) | 401 | Hayır |
| [`credential_revoked`](/tr/developers/v1/errors/credential_revoked) | 401 | Hayır |
| [`not_entitled`](/tr/developers/v1/errors/not_entitled) | 403 | Hayır |
| [`insufficient_permission`](/tr/developers/v1/errors/insufficient_permission) | 403 | Hayır |
| [`permission_denied`](/tr/developers/v1/errors/permission_denied) | 403 | Hayır |
| [`resource_not_found`](/tr/developers/v1/errors/resource_not_found) | 404 | Hayır |
| [`invalid_request`](/tr/developers/v1/errors/invalid_request) | 400 veya 409 | Hayır |
| [`invalid_filter`](/tr/developers/v1/errors/invalid_filter) | 400 | Hayır |
| [`unsupported_version`](/tr/developers/v1/errors/unsupported_version) | 400 | Hayır |
| [`idempotency_key_reuse`](/tr/developers/v1/errors/idempotency_key_reuse) | 409 | Çakışmaya bağlıdır |
| [`rate_limited`](/tr/developers/v1/errors/rate_limited) | 429 | Evet |
| [`service_unavailable`](/tr/developers/v1/errors/service_unavailable) | 503 | Evet |
| [`internal_error`](/tr/developers/v1/errors/internal_error) | 500 | Evet |

Kod kümesi kapalıdır: yeni kodlar genel sözleşmede bir değişiklik anlamına gelir ve API değişiklik günlüğü aracılığıyla duyurulur. `retryable: true` yanıtı, durumun kendiliğinden çözülebileceği anlamına gelir; bir yazma işleminin hiçbir etkisinin olmadığını kanıtlamaz. Okuma isteklerini sınırlı sayıda deneme ve sınırlı bir süre bütçesiyle, üstel geri çekilme (exponential backoff) ve jitter kullanarak yeniden deneyin. Yeniden denenebilir bir `409` veya `429` yanıtı da dahil olmak üzere, `Retry-After` mevcut olduğunda ona uyun.

Değişiklik yapan işlemlerde, ilgili işlemin belgelenmiş idempotency ve kurtarma sözleşmesini izleyin. Destekleniyorsa özgün anahtarı ve isteği koruyun. Zaman aşımından veya `5xx` hatasından sonra yeni bir anahtar üretmeyin: bu, başarılı olmuş bir yazma işleminin yinelenmesine neden olabilir. `Idempotency-Key` üst bilgisi, bunu desteklemeyen bir işlemde herhangi bir koruma sağlamaz.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.