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

# Hatalar ve Sınırlar

> Yaygın API hatalarını, sayfalandırma sınırlarını ve güvenli yeniden deneme davranışını anlayın.

Plato API'leri mümkün olan yerlerde JSON hata iletilerini döndürür.

## Hata Şekli

REST uç noktaları genellikle şu şekillerden birini döndürür:

```json theme={null}
{
  "message": "No apiKey provided."
}
```

```json theme={null}
{
  "error": "Unauthorized API key."
}
```

Bir REST isteği başarısız olduğunda HTTP durumunu, yanıt gövdesini ve istek kimliğini günlüğe kaydedin.

## Ortak Durum Kodları

| Durum | Anlam                                                                                                     |
| ----- | --------------------------------------------------------------------------------------------------------- |
| `400` | İstek geçersiz, gerekli alanlar eksik veya doğrulama başarısız.                                           |
| `401` | API anahtarı eksik, süresi dolmuş, geçersiz veya işlem için izin verilmiyor.                              |
| `403` | API anahtarı geçerli ancak rolü gerekli izne sahip değil.                                                 |
| `404` | İstenen kayıt API anahtar çalışma alanında mevcut değil.                                                  |
| `429` | Rota hız sınırlıdır. Yavaşlayın ve daha sonra tekrar deneyin.                                             |
| `500` | Plato isteği tamamlayamadı. Daha sonra tekrar deneyin veya tekrarlanırsa destek ekibiyle iletişime geçin. |

## Sayfalandırma Sınırları

Farklı API'ler farklı sayfalandırma stillerini ortaya çıkarır.

CMS listesi uç noktaları şunları kullanır:

```text theme={null}
limit: 1 to 100
offset: 0 or higher
```

Menü uç noktaları şunları kullanır:

```text theme={null}
page: 1 or higher
limit: 1 to 100
```

Connect360 liste işlemleri imleçleri kullanır:

```ts theme={null}
{
  limit: 50,
  cursor: "next_cursor"
}
```

## Sipariş Besleme Sınırları

Restoran siparişi feed'i, istek başına en fazla 50 siparişi döndürür.

Hem `date` hem de `endDate` sağlandığında tarih aralıkları 5 güne kadar olabilir.

## Kılavuzu Yeniden Deneyin

Yalnızca arıza geçici olduğunda yeniden deneyin.

Yeniden dene:

* Ağ zaman aşımları.
* Bekledikten sonra `429`.
* Kısa bir gecikmeden sonra `500` veya `503`.

Düzeltilinceye kadar yeniden denemeyin:

* Geçersiz API anahtarı.
* İzin eksik.
* Bilinmeyen alan.
* Gerekli alan eksik.
* Geçersiz ilişki kimliği.

## iktidarsızlık

Toplayıcı siparişi oluşturma, `aggregator` ve `externalOrderId` ile idempotenttir ve `Idempotency-Key` başlığını da kabul eder.

CMS oluşturma, form gönderme ve mesaj gönderme gibi yazma işlemleri, her çağrıldıklarında yeni kayıtlar oluşturabilir. Yinelenen gönderimler mümkün olduğunda kendi entegrasyonunuzu bağımsız hale getirin.