الانتقال إلى المحتوى الرئيسي
سترجع الأخطاء مع رموز حالة HTTP القياسية. رموز الحالة هي كما يلي:
  • 1xx: معلوماتي - ينقل معلومات على مستوى بروتوكول النقل.
  • 2xx: نجاح - كان الطلب ناجحًا.
  • 3xx: إعادة توجيه - يجب على العميل اتخاذ بعض الإجراءات الإضافية لإكمال الطلب.
  • 4xx: خطأ من العميل - فشل الطلب بسبب خطأ من العميل.
  • 5xx: خطأ في الخادم - فشل الطلب بسبب خطأ في الخادم.

​
200 نجاح

تم إجراء طلب ناجح.

​
400 طلب سيّئ

يعني الخطأ 400 Bad Request أن الخادم غير قادر على متابعة الطلب. السبب الأكثر شيوعًا للخطأ هو الصياغة السيئة في عنوان URL للطلب أو الجسم.

​
401 غير مصرّح به

عادة ما تكون أخطاء 401 Unauthorized ناتجة عن مشكلة في رأس طلب استدعاء API الخاص بك، أي أنك لم تستخدم مفتاح API صالحًا لإجراء استدعاء API.

​
403 تم رفض الوصول

عندما يقوم تطبيقك بإجراء استدعاء API باستخدام مفتاح API الخاص بك ولا يُسمح بالطلب. قد يُعاد 403 أيضًا إذا تمّ تعليق ملف تعريف المستخدم.

​
404 المورد غير موجود

يحدث هذا الخطأ عندما يحاول تطبيقك استدعاء API أو جلب كيان غير موجود.

​
405 الطريقة غير مسموح بها

يشير هذا الخطأ إلى أن طرق بروتوكول HTTP في طلبك غير مدعومة. تحقّق من الوثائق الخاصة بـ API لمعرفة الطرق المدعومة.

​
429 حد المعدّل

​
حدود معدّل ملف تعريف المستخدم

كل ملف تعريف مستخدم لديه حد معدّل قدره 300 طلب API لكل فاصل زمني قدره 5 دقائق. يمكنك مراقبة استخدام حد المعدّل الخاص بك من خلال رؤوس الاستجابة:
  • x-ratelimit-max: يعرض الحد الأقصى من الطلبات المسموح بها لكل فترة 5 دقائق
  • x-ratelimit-count: يعرض عدد الطلبات التي أجريتها في فترة الـ 5 دقائق الحالية
نوصي بالتحقق من استجابات رمز خطأ 429. إذا رأيت خطأ 429، فقد وصلت إلى حد المعدّل الخاص بك. قد تؤدّي المحاولات المتكرّرة لتجاوز حد المعدّل إلى تعليق ملف تعريف المستخدم.تعرّف على المزيد حول التعامل مع حدود المعدّل لملفات تعريف المستخدمين المتعدّدة.

​
حدود معدّل تحليلات المنصّة

قد يُعاد HTTP 429 أيضًا عندما تُقيّد شبكة اجتماعية استدعاءات التحليلات لحساب محدّد — بشكل مستقل عن حدود ملف تعريف المستخدم في Ayrshare. في هذه الحالة، تحمل الاستجابة رمز خطأ خاصًا بالمنصّة من Ayrshare (على سبيل المثال code: 444 لتقييدات تحليلات كل صفحة Facebook). افحص حقل code للتمييز بين حد معدّل الملف الشخصي وتقييد جانب المنصّة، وأعد المحاولة مع تراجع بدلاً من مطالبة المستخدم بإعادة الربط.

​
حدود معدّل حذف ملف تعريف المستخدم

يمكنك حذف 8 ملفات تعريف مستخدم في الثانية. يُرجى توزيع استدعاءات API إذا كنت بحاجة إلى حذف مجمّع.

​
حماية حد المعدّل وسياسة التعليق

لحماية سلامة نظامنا، ننفّذ تعليقًا تلقائيًا إذا تجاوز ملف تعريف المستخدم حدود المعدّل بشكل متكرّر جدًا. إليك كيفية عمله: عند إجراء طلبات API، يجب عليك إدارة نافذة الـ 5 دقائق بعناية. على سبيل المثال، إذا أجريت 300 طلب في دقيقة واحدة، فستحتاج إلى الانتظار أربع دقائق أخرى قبل إجراء طلبات إضافية. سيؤدّي أي طلبات خلال فترة الانتظار هذه إلى تشغيل استجابة خطأ 429. إذا تراكم لدى ملف تعريف مستخدم 1000 انتهاك لحد المعدّل (أخطاء 429) خلال فترة 24 ساعة، فسيتم تعليق الملف الشخصي تلقائيًا. بعد انقضاء فترة انتظار مدتها 5 دقائق، يمكنك استئناف إجراء الطلبات حتى الحد القياسي البالغ 300 لكل نافذة 5 دقائق.

​
500 خطأ داخلي في الخادم

يشير 500 Internal Server Error إلى أن Ayrshare تواجه خطأً داخليًا أو أن المعالجة فشلت.