# Hız limitleri

Bir anahtarın kaç çağrı yapabileceği ve nerede olduğunuzu nasıl okuyacağınız.

Çağrılar anahtar ve çağrı türü başına, dakikalık sayılır; anahtar başına bir genel sınır da vardır. Her yanıt nerede olduğunuzu söyler.

| Çağrı türü | Ad | Dakikada |
| --- | --- | --- |
| Tek kayıt okuma | get | 600 |
| Kayıt listeleme | list | 240 |
| Kayıt değiştirme | update | 240 |
| Kayıt arama | search | 120 |
| Kayıt oluşturma | create | 120 |
| Anahtar bilgisi | me | 60 |
| Özellik listesi | properties | 60 |

### Başlıklar

```http
X-RateLimit-Limit: 240
X-RateLimit-Remaining: 238
X-RateLimit-Reset: 1794313700
```

| Başlık | Anlamı |
| --- | --- |
| X-RateLimit-Limit | Bu çağrı türü için pencerede izin verilen çağrı sayısı. |
| X-RateLimit-Remaining | Penceredeki kalan çağrı (türün ve anahtarın genel sınırının küçüğü). |
| X-RateLimit-Reset | Pencerenin sıfırlanacağı an, saniye. |
| Retry-After | 429'da: tekrar denemeden önce beklenecek saniye. |

### Sınır aşılınca

```http
HTTP/1.1 429 Too Many Requests
Retry-After: 20

{ "statusCode": 429, "message": "Too many requests: slow down" }
```

Retry-After kadar bekleyip tekrar deneyin. Her başarısız denemede daha uzun bekleyin. Kayıtlar üzerinde döngü yapan bir program, 429'a çarpmadan önce X-RateLimit-Remaining'i okuyup kendini yavaşlatmalıdır.