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

# Günlük istek limiti

> API anahtarı başına günlük istek hakkı ve limit header'ları.

Her API anahtarının Noyax tarafından belirlenen bir **günlük istek limiti** vardır. Sayaç API anahtarı başına tutulur: aynı anahtarı kullanan tüm sunucularınız aynı limiti paylaşır.

## Header'lar

Yetki kontrolünü geçen her yanıtta kalan hakkınız döner:

| Header              | Anlamı                        |
| ------------------- | ----------------------------- |
| `X-Daily-Limit`     | Anahtarın günlük istek limiti |
| `X-Daily-Remaining` | Bugün kalan istek sayısı      |

```http theme={null}
HTTP/1.1 200 OK
X-Daily-Limit: 10000
X-Daily-Remaining: 9874
```

## Limit aşılırsa

Limit dolduğunda istek işlenmez ve **429** döner:

```json theme={null}
{
  "Success": false,
  "ResultCode": "0120",
  "Message": "Daily request limit (10000) exceeded.",
  "Errors": [
    { "Code": "0120", "Message": "Daily request limit (10000) exceeded." }
  ]
}
```

Sayaç her gün **gece yarısı (Türkiye saati)** sıfırlanır. 429 aldıktan sonra aynı gün yeniden denemek sonuç vermez.

## Neler sayılır?

* Token ve header doğrulamasını, yetki kontrolünü geçen **tüm istekler** sayılır. Buna iş kuralı hatasıyla dönen (400, 404) istekler de dahildir.
* Geçersiz token (401), header hatası (400) ya da yetki hatası (403) ile reddedilen istekler **sayılmaz**.

## Öneriler

* Liste endpoint'lerinde büyük `pageSize` (en fazla 50) kullanarak istek sayısını azaltın.
* Değişmeyen verileri kendi tarafınızda önbelleğe alın.
* `X-Daily-Remaining` değerini izleyin ve azaldığında toplu işlemleri erteleyin.
* Daha yüksek bir limite ihtiyacınız varsa Noyax destek ekibiyle görüşün. Yeni limit, yeni token aldığınızda geçerli olur.
