الأخطاء

أكواد الأخطاء وملف OpenAPI.

HTTP 4xx/5xx
{
  "code": "INVALID_TO",
  "message": "INVALID_TO",
  "retryable": false,
  "request_id": "…"
}

`401 UNAUTHORIZED`	المفتاح مفقود أو غير صحيح.
`403 ACCOUNT_SUSPENDED`	الحساب موقوف.
`403 FORBIDDEN`	المفتاح لجلسة أخرى، أو instance_id لا يطابق المفتاح.
`403 SUBSCRIPTION_INACTIVE`	لا يوجد اشتراك فعّال.
`403 SUBSCRIPTION_EXPIRED`	انتهت فترة الاشتراك.
`403 TRIAL_MESSAGE_LIMIT`	نفد رصيد رسائل التجربة.
`404 NOT_FOUND`	المورد غير موجود (رسالة، جلسة، أو رسالة unknown بلا قرار).
`404 MEDIA_NOT_FOUND`	media_id غير موجود أو انتهت صلاحيته.
`409 IDEMPOTENCY_CONFLICT`	نفس Idempotency-Key استُخدم مع جسم مختلف.
`409 CANNOT_CANCEL`	الرسالة ليست في الطابور أو بدأ إرسالها.
`413 MEDIA_TOO_LARGE`	الملف أكبر من الحد المسموح.
`422 VALIDATION_ERROR`	جسم الطلب غير صالح أو ينقصه حقل مطلوب.
`422 INVALID_TO`	رقم المستلم غير صالح.
`422 INVALID_MEDIA`	حدد media_id أو url (واحد فقط).
`422 INVALID_TEXT`	النص فارغ أو أطول من 8192 حرفاً.
`422 INVALID_CAPTION`	caption أطول من 2048 حرفاً.
`422 CONFIRM_DUPLICATE_REQUIRED`	resend يتطلب confirm_duplicate = true.
`429 RATE_LIMITED`	تجاوزت حد الطلبات — انتظر عدد الثواني في Retry-After ثم أعد المحاولة.
`503 STORE_FAILED`	خطأ مؤقت — أعد المحاولة بنفس Idempotency-Key.

retryable = true يعني أن إعادة الطلب نفسه لاحقاً آمنة. احتفظ بـ request_id عند التواصل مع الدعم.

GET /openapi.yaml