مركز المساعدةمركز المساعدة / المطورون · مفهوم
رموز الحالة والرسائل التي تعيدها واجهات API والـWebhooks، وسبب كل منها، وطريقة إصلاحه.
هذه الصفحة ترجمة آلية ولم تُراجع بعد.
أرسل Accept: application/json مع كل طلب. دونها تعود بعض الأخطاء كصفحة ويب أو إعادة توجيه.
/api/webhook/...)رسائل نقطة نهاية بعينها، مثل 409 في العملاء أو 404 في المنتجات، موجودة في صفحة تلك النقطة. ابدأ من تبويب Webhooks/Pushers.
| الحالة والرسالة | السبب | الحل |
|---|---|---|
| 401 "Authentication failed" | لا يوجد رمز، أو الرمز خاطئ، أو أُنشئ رمز ولم يُحفظ | في Webhooks/Pushers، اختر حفظ الإعدادات. أرسل الرمز بالصيغة Authorization: Bearer <your token> |
| 401 "Item webhook is not enabled for this shop"، أو الرسالة نفسها مع "User webhook" | الزر متوقف | فعّله واحفظ |
| 400 "Vendor webhook is not enabled for this shop" | Webhook نوع التاجر متوقف | فعّله واحفظ |
| 402 "… is not included in your plan. …" | الباقة لا تشمل الميزة | راجع الباقة والوصول |
| 402 أو 403 "The shop's plan has ended: it is read-only until it is renewed." | نقطتا نهاية الطلبات فقط ما زالتا تعملان | جدّد من المتجر › الباقة والفوترة |
| 422 "Validation failed" | حقل مفقود أو نوعه خاطئ. data تسمّي كل حقل | صحّح الحقول. التواريخ بالصيغة YYYY-MM-DD HH:MM:SS |
| 429 | أكثر من 500 طلب في الدقيقة | أرسل صفوفًا أكثر في طلبات أقل |
/api/shop/...)| الحالة والرسالة | السبب | الحل |
|---|---|---|
| "username or password incorrect" | بريد إلكتروني أو كلمة مرور خاطئة، أو الحساب ليس لمالك متجر أو موظف | استخدم حساب مالك أو موظف |
| "invalid auth_token or user_id" | الرمز ليس المحفوظ لذلك المستخدم، مثلًا بعد إعادة الإنشاء | احفظ أحدث رمز |
| 403 "Unauthorized." | لا يوجد رمز Bearer، أو الرمز مرفوض | أرسل Authorization: Bearer <your token>، أو سجّل الدخول من جديد |
| العَرَض | السبب | الحل |
|---|---|---|
| Webhooks المتجر غير موجود في قائمة المتجر | الباقة لا تشمل الميزة | راجع الباقة والوصول |
| لا يصل شيء | الـWebhook في حالة متوقف مؤقتًا، أو الحدث غير محدد، أو الطلب تجريبي | عدّل الـWebhook. اختبر بطلب حقيقي |
| بعض الأحداث مفقودة | فشل خادمك في ثلاث محاولات | رُدّ بحالة 2xx خلال 3 ثوانٍ. راجع التسليم وإعادة المحاولة |
| فحص التوقيع لديك يفشل | تم تحليل المحتوى وإعادة تسلسله، أو المفتاح السري خاطئ | احسب على المحتوى الخام. اطلب مفتاح التوقيع السري من الدعم |
| لا تصل أحداث العملاء | تُرسل فقط للعملاء الذين لهم رقم شريك | راجع الأحداث |
| العَرَض | السبب | الحل |
|---|---|---|
| مفعّل مقفل بشارة تديره المنصة | الباقة لا تشمل «أنظمة ERP والمحاسبة (ERPNext، Zoho)» | راجع الباقة والوصول |
| طلب ليس له طلب ERPNext | لم يبلغ حدث الإرسال بعد، أو فشلت المحاولة | افتح الطلب. خطأ ERPNext: › عرض يعرض ما أجاب به ERPNext |
| بنود مفقودة من أمر البيع | تلك المنتجات ليس لها باركود | أضف باركودات تطابق أكواد المنتجات في ERPNext |