الأخطاء

لكل استجابة خطأ الشكل نفسه:


{
  "error": {
    "code": "invalid_request",
    "message": "title is required"
  }
}

رموز الأخطاء

الرمز	الحالة	المعنى
`unauthorized`	401	مفتاح API مفقود أو مشوّه أو ملغى أو غير معروف.
`forbidden`	403	مفتاح صالح، لكن الخطة لا تسمح بهذا الإجراء (الكتابة تتطلّب خطة مدفوعة).
`invalid_request`	400	فشل التحقق — JSON خاطئ، أو حقل مفقود، أو معامل استعلام غير صالح.
`not_found`	404	مسار غير معروف أو لا يوجد مورد بهذا المعرّف في مشروعك.
`limit_reached`	429	نفدت حصة الطلبات الشهرية.
`rate_limited`	429	طلبات كثيرة جدًا في النافذة الحالية — تمهّل وأعد المحاولة.
`internal_error`	500	فشل شيء لدينا. من الآمن إعادة المحاولة.

هذه القائمة شاملة — فالـ API لا يعيد أي رموز أخرى.