# Hata Kodları

API yanıtları standart HTTP durum kodlarını kullanır:

| Kod | Açıklama |
|---|---|
| `200` | İşlem (GET veya PUT) başarı ile sonuçlandı. |
| `201` | Oluşturma işlemi (POST) başarı ile sonuçlandı. |
| `204` | Silme isteği başarı ile sonuçlandı. (cevapta içerik bulunmaz.) |
| `400` | İstek gövdesi bozuk veya doğrulama hatası (alan bazlı hatalar `errors` içinde). |
| `401` | Access token eksik, geçersiz veya süresi dolmuş ya da Admin API'de istemcinin bu işlem için izni yok. |
| `403` | İstemcinin bu operasyona özel gerekli yetkileri yok. |
| `404` | Talep edilen nesne sunucuda bulunamadı. |
| `405` | Bu operasyon tipine (GET, POST, PUT veya DELETE) izin verilmiyor. |
| `429` | Belli bir süre içerisinde çok fazla istek yapıldı. |
| `500` | Sunucuda bir hata oluştu ve istek karşılanamadı. |
| `503` | Sunucu şu anda hizmet vermiyor (kapalı veya erişilemiyor). |

Doğrulama hataları `422` değil `400` koduyla döner.

## Hata gövdesi

Uygulama kaynaklı hatalar (`400`, `403`, `404`, `500` ve Admin API'de izin hatası olan `401`) aynı JSON gövdesini döner. `errorMessage`, `x-ideasoft-locale` istek başlığına göre çevrilir.

```json
{
  "code": 400,
  "errorMessage": "Validation Error.",
  "errorCode": 300001,
  "errors": {
    "name": "This value should not be blank."
  }
}
```

| Alan | Açıklama |
|---|---|
| `code` | HTTP durum kodu. |
| `errorMessage` | Hata mesajı. |
| `errorCode` | Uygulamaya özgü hata kodu: doğrulama hatalarında `300001`, tanımsız hatalarda `0`. |
| `errors` | Doğrulama hataları. Admin API alan adı → mesaj nesnesi, Store API `{alan adı: mesaj}` nesnelerinden oluşan dizi döner. |

Access token eksik, geçersiz veya süresi dolmuşsa `401` yanıtı OAuth hata biçimindedir:

```json
{
  "error": "invalid_grant",
  "error_description": "The access token provided is invalid."
}
```

:::info{title="Tekrar deneme"}
`429` ve `5xx` yanıtlarında isteği üstel geri çekilme (exponential backoff) ile tekrar denemeniz önerilir. `4xx` hatalarında tekrar denemeyin; önce isteğinizi düzeltin.
:::

## Cloudflare Hataları

Endpoint'e ulaşmadan alınan Cloudflare kaynaklı hatalar için: [Cloudflare hata kodları](https://developers.cloudflare.com/support/troubleshooting/cloudflare-errors/)
