Rasel Mailمرجع الأخطاء وتشخيص طلبات API
اقرأ HTTP ورمز الخطأ قبل اختيار إعادة المحاولة.
آخر تحديث تحريري: ٣٠ أكتوبر ٢٠٢٦في هذا الدليل
أخطاء إرسال المواقع
| الرد | المعنى والإجراء |
|---|---|
| 400 INVALID_INPUT | راجع JSON والحقول والمستلمين والمفتاح المطلوب لمنع التكرار. |
| 401 INVALID_DELIVERY_KEY | راجع مفتاح المشروع وهل تم تدويره أو إيقافه. |
| 403 INVALID_SENDER | from لا ينتمي للدومين المسموح للمشروع. |
| 402 TRANSACTIONAL_QUOTA_REQUIRED / TRANSACTIONAL_QUOTA_EXHAUSTED | لا توجد حصة سارية أو انتهت؛ راجع الشراء والتفعيل. |
| 409 IDEMPOTENCY_CONFLICT | أعدت المفتاح نفسه مع محتوى مختلف؛ راجع حدث العمل. |
| 404 NOT_FOUND | راجع المعرف ومفتاح المشروع؛ لا يمكن قراءة رسالة مشروع آخر. |
| 429 PUBLIC_RATE_LIMIT | انتظر قبل إعادة الطلب؛ هذا يختلف عن انتهاء الحصة. |
شكل خطأ نموذجي
{"error":"IDEMPOTENCY_CONFLICT"}أخطاء OAuth
- invalid_client: راجع Basic authentication وclient_id والسر الحالي.
- invalid_grant: code أو refresh غير صالح، أو verifier أو callback غير مطابق، أو تم إلغاء الربط. ابدأ موافقة جديدة عند الحاجة.
- access_denied: المستخدم رفض الطلب؛ لا تعيد الموافقة تلقائيًا.
- INVALID_TOKEN في قراءة الموارد: راجع access token وصلاحيته وملكية الصندوق في الربط.
ماذا تحفظ للتشخيص؟
سجّل اسم endpoint ووقت الطلب وHTTP status ورمز error ومعرف الرسالة إن وجد. احذف Authorization والأسرار ومحتوى البريد وروابط التفعيل من أي سجل أو صورة. لا تعالج timeout بإنشاء مفتاح إرسال جديد لنفس الحدث.