> ## 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.

# الأخطاء والحدود

> افهم أخطاء API الشائعة وحدود ترقيم الصفحات وسلوك إعادة المحاولة الآمن.

تقوم واجهات برمجة التطبيقات Plato بإرجاع رسائل الخطأ JSON حيثما أمكن ذلك.

## شكل الخطأ

عادةً ما تُرجع نقاط نهاية REST أحد هذه الأشكال:

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

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

عند فشل طلب REST، سجّل حالة HTTP ونص الاستجابة ومعرّف الطلب.

## رموز الحالة المشتركة

| حالة  | معنى                                                                           |
| ----- | ------------------------------------------------------------------------------ |
| `400` | الطلب غير صالح، أو يفتقد الحقول المطلوبة، أو فشل التحقق من الصحة.              |
| `401` | مفتاح API مفقود أو منتهي الصلاحية أو غير صالح أو غير مسموح به للعملية.         |
| `403` | مفتاح API صالح ولكن دوره لا يتمتع بالإذن المطلوب.                              |
| `404` | السجل المطلوب غير موجود في مساحة عمل المفتاح API.                              |
| `429` | الطريق محدود السعر. أبطئ ثم أعد المحاولة لاحقًا.                               |
| `500` | تعذر على Plato إكمال الطلب. أعد المحاولة لاحقًا أو اتصل بالدعم إذا تكرر الأمر. |

## حدود الصفحات

تعرض واجهات برمجة التطبيقات المختلفة أنماطًا مختلفة لترقيم الصفحات.

تستخدم نقاط نهاية قائمة CMS:

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

استخدام نقاط نهاية القائمة:

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

تستخدم عمليات قائمة Connect360 المؤشرات:

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

## حدود تغذية الطلب

تقوم خلاصة طلبات المطعم بإرجاع ما يصل إلى 50 طلبًا لكل طلب.

يمكن أن تصل النطاقات الزمنية إلى 5 أيام عند توفير كل من `date` و`endDate`.

## إعادة محاولة التوجيه

أعد المحاولة فقط عندما يكون الفشل مؤقتًا.

إعادة المحاولة:

* مهلات الشبكة.
* `429` بعد الانتظار.
* `500` أو `503` بعد مهلة قصيرة.

لا تقم بإعادة المحاولة حتى يتم إصلاحه:

* مفتاح API غير صالح.
* إذن مفقود.
* حقل غير معروف.
* الحقل المطلوب مفقود.
* معرف العلاقة غير صالح.

## العجز

إنشاء طلبات المجمّعين عملية آمنة للتكرار باستخدام `aggregator` و`externalOrderId`، كما تقبل ترويسة `Idempotency-Key`.

يمكن لعمليات الكتابة مثل إنشاء CMS وإرسال النموذج وإرسال الرسائل إنشاء سجلات جديدة في كل مرة يتم الاتصال بها. اجعل التكامل الخاص بك غير فعال عندما تكون عمليات الإرسال المكررة ممكنة.