تخطي إلى المحتوى
Rankupedia
Rankupediaإنشاء حساب

مدخل: الأخطاء

استدعاءات فحص درجة النطاق التي تفشل: 401، 402 والصفوف الفارغة

مدخل: الأخطاء. يحمل رمزان HTTP دلالة، وتعلمك علامة واحدة ما إذا كانت الاستدعاءة قد اكتملت، وتشرح خاصية البيانات معظم المفاجآت.

جسر حجري مكسور مع قسم مفقود وثلاثة مفاتيح على طالة مغطاة بالطحلب

العرض، السبب، الإصلاح

العرضالسبب المحتملالإصلاح
HTTP 401المفتاح مفقود، أو مُدخل بشكل خاطئ، أو ملغىأرسل key=sk_... أو رأس Bearer؛ انسخ المفتاح مرة أخرى من صفحة الحساب
HTTP 402نفدت الرصيدأضف رصيداً بعملة USDT (TRC-20)؛ لا تزال الإجراءات المجانية تعمل
ok هي falseلم تكتمل الاستدعاءةاقرأ حالة HTTP أولاً، ثم جسم الاستجابة
يبدو أن النطاق غير مُدرجة درجتهروابط قليلة أو معدومة في الفهرسراجع النطاقات المرجعية؛ تعني DR بقيمة 0 أنه لم يتم العثور على أي منها
الروابط الحديثة مفقودةيتم تحديث الفهرس شهرياً تقريباًانتظر التحديث التالي؛ لا تقم بإعادة المحاولة في حلقة
توقف الصفوف بعد 50,000 صفحد التصفححدد نطاقاً أوسع باستخدام استعلام أو ترتيب، ثم تصفح مرة أخرى
تم رفض الاستدعاء الجماعيأكثر من 2,000 نطاققسم القائمة إلى أجزاء
الحدود في مكان واحد

المدفوعات تكون بعملة USDT على شبكة TRC-20. تسجيل الدخول متاح عبر Google فقط. القوائم الجماعية محدودة بـ 2,000 نطاق، واستدعاءات القائمة بـ 1,000 صف، والتصفح العميق بـ 50,000 صف.

ترتيب التشخيص

ابدأ بفحص رمز الحالة. يشير الرمز 401 إلى هوية المستخدم، بينما يرتبط الرمز 402 بالدفع. يتم إصلاح كل منهما في مكان مختلف.

ثم اقرأ ok. تحمل كل استجابة هذا الحقل. في الاستدعاءات المصادق عليها، يُظهر _credits التكلفة والرصيد المتبقي، مما يسمح لك باكتشاف استنفاد الرصيد قبل ظهور رمز 402.

حافظ على هذا الترتيب الثابت في دليل التشغيل الخاص بك. أي شخص ينتقل مباشرة إلى البيانات قد يضيع صباحاً في حل مشكلة كان بإمكان رمز الحالة تحديدها فوراً.

فقط بعد ذلك يجب أن تشك في صحة البيانات. غالباً ما يظهر الموقع الجديد درجة DR منخفضة. نادراً ما يكون السبب خطأً برمجياً، والسبب الأرجح هو لقطة شهرية تسبق وجود الروابط. قارن الرقم مع مدخل الصيغة.

فصل المشكلة الرئيسية عن مشكلة الرصيد

يبدو الرمز 401 والرمز 402 متشابهين في السكربت، لأن كليهما يوقف نفس الحلقة. لهما أسباب مختلفة، لذا افصل بينهما قبل إجراء أي تغيير.

ابدأ بإجراء مجاني على نفس النطاق. إذا استجاب الطلب المجاني ولم يستجب الطلب المدفوع، فإن النطاق سليم والمشكلة تكمن في المفتاح أو الرصيد.

عندما يتبع رمز 401 عملية النسخ

يُعد المفتاح المنسوخ مع وجود مسافة في نهايته أو مقطوعاً في نهايته سبباً شائعاً لخطأ 401. تبدأ المفاتيح بـ sk_، لذا تحقق من هذا البادئ وقارن السلسلة الكاملة مع النسخة الموجودة في صفحة الحساب.

استبدل المفتاح في مكان واحد وأعد تشغيل نفس الاستدعاء الفردي. إن تغيير عدة عوامل في وقت واحد يجعل من المستحيل قراءة النتيجة.

عند ظهور خطأ 402 بعد الشحن

يعني خطأ 402 أن الإجراء المدفوع لم يعد لديه رصيد متبقي. اقرأ الرصيد المتبقي من _الائتمانات في الاستجابة المصادق عليها التالية قبل أي شيء آخر.

إذا بدا هذا الرصيد صحيحاً، قارنه بتكلفة الاستدعاء الذي فشل. ستوضح الأرقام ما إذا كان الاستدعاء ببساطة أكبر من الرصيد المتاح.

احتفظ بملاحظة عن وقت الشحن، بحيث يمكن مقارنة السجل والرصيد لاحقاً.

تدوين ملاحظة حول الرصيد قبل وبعد كل عملية شحن يجعل قراءة خطأ 402 التالي أسهل.

التعامل مع نتيجة فارغة

01

تأكد من اكتمال الاستدعاء

اقرأ التوثيق أولاً. تعني القيمة "خطأ" أن الطلب لم يكتمل، لذا فإن القائمة الفارغة لا تخبرك شيئاً عن النطاق.

02

تحقق من الاسم الذي أرسلته

يجب أن تكون قيمة "q" نطاقاً خاماً. يمكن أن يؤدي وجود مخطط (scheme)، أو مسار، أو فراغ زائد إلى إجابة فارغة تبدو حقيقية.

03

قارن مع إجراء مجاني

شغّل نظرة عامة على نفس الاسم. إذا أعادت البيانات ولم يعيد القائمة، فإن إجراء القائمة وحدوده هما المشتبه بهما التاليان.

04

تحقق من تاريخ التحديث

يتم تحديث الفهرس مرة واحدة تقريباً في الشهر. لن يظهر الرابط المضاف بعد آخر تحديث، بغض النظر عن عدد المرات التي تستدعي فيها نقطة النهاية.

زنبرك مشدود واحد في ترس خشبي لساعة ميكانيكية على طاولة عمل

سياسة إعادة المحاولة الدنيا

  • لا تعيد محاولة أخطاء 401 أو 402 تلقائياً
  • أعد محاولة أخطاء الشبكة بفترات تأخير متزايدة
  • توقف عندما يُظهر _credits رصيداً قريباً من الصفر
  • احفظ الإجابات الناجحة لمدة شهر
  • سجّل الإجراء والنطاق مع كل فشل

أسئلة الحافة

هل يتم خصم الرصيد لطلب فاشل؟

لا نحدد قاعدة فوترة للطلبات الفاشلة في هذا المرجع. راقب _credits في الاستجابة المصادق عليها التالية وقارن الرصيد المتبقي بتوقعاتك.

لماذا يعمل الإجراء المجاني بعد خطأ 402؟

لأن domain و overview و stats و suggest لا تحتاج إلى مفتاح ولا رصيد. يتم حظر الإجراءات المدفوعة فقط عندما يكون الرصيد فارغاً.

من أين تأتي أسماء الحقول؟

اطلع على مدخل حقل API لمعرفة الشكل العام، ثم استدعِ نقطة نهاية حية للحصول على صفوف محددة للإجراء.

لماذا قد يبدو الرقم غير صحيح دون وجود أي خطأ

أحيانًا تصل جميع الحقول في الوقت المحدد، ومع ذلك يفاجئك الرقم. الاستجابة صحيحة بالنسبة إلى لقطة البيانات الخاصة بها، لذا فإن السؤال الحقيقي هو ما الذي تحتويه تلك اللقطة.

تشرح ثلاثة سيناريوهات معظم هذه الحالات.

نطاق أُطلق مؤخرًا

قد يُظهر الموقع الذي أُطلق مؤخرًا قيمة DR 0 لأن لقطة البيانات تسبق وجود روابطه. تعني الصفر هنا عدم العثور على مجال رابط، وليس حكمًا على الموقع.

انتظر تحديثًا لاحقًا قبل أن تقرأ الرقم كحكم على الموقع.

قارن عمر النطاق مع دورة التحديث قبل اتخاذ إجراء. يبدو الاسم الجديد والاسم القديم الذي لم يجذب روابط متشابهين في نفس لقطة البيانات.

رابط أُضيف هذا الشهر

الروابط المضافة بعد آخر تحديث غير موجودة في الرقم. يؤدي الاستدعاء المتكرر إلى إرجاع نفس الإجابة حتى وصول التحديث التالي.

لاحظ تاريخ الرابط وتاريخ لقطة البيانات، بحيث يكون الفارق سهل الشرح لأي شخص يقرأ التقرير.

رابط اختفى

يمكن أن يختفي الرابط عند حذف صفحته أو إغلاق موقع المانح. ينخفض العدد بعد ذلك على الرغم من عدم تغيير أي شيء من جانبك.

قارن بين لقطتين بيانات تفصل بينهما عدة أشهر قبل أن تلوم نقطة النهاية.

احسب عدد المجالات التي تتحرك، وليس فقط المجموع. الخسارة الصغيرة المنتشرة عبر مواقع عديدة تظهر بشكل مختلف عن الخسارة الكبيرة من موقع واحد.

أين يقع كل إصلاح

الإصلاحالمكان
مفتاح جديد أو منسوخصفحة الحساب
إضافة رصيد بعملة USDT (TRC-20)صفحة الحساب
التجزئة وإعادة المحاولةكود العميل الخاص بك
الانتظار حتى التحديثلا يوجد إجراء مطلوب؛ تحدث تحديثات الفهرس تقريبًا شهريًا
عدسة مكبرة فوق عقدة شجرة مع قطرة ماء تسقط بالقرب منها

إعادة إنتاج فشل لإعداد تقرير عن خطأ

01

تقليل الأمر إلى استدعاء واحد

أزل الحلقة واحتفظ بأمر curl واحد يفشل.

02

تسجيل الاستجابة

سجل حالة HTTP، وقيمة ok وحقل _credits إذا كان موجودًا.

03

جرّب إجراءً مجانيًا على نفس النطاق

إذا نجح overview ولم ينجح الإجراء المدفوع، فإن الخطأ في المفتاح أو الرصيد، وليس في النطاق.

04

إرسال التفاصيل

سجل الوقت، والإجراء، والحرفين الأول والأخير من المفتاح، بحيث يمكن مطابقة الاستدعاء مع الحساب. احتفظ بالمفتاح الكامل خارج التقرير.

ما الذي يجب تسجيله مع كل استدعاء فاشل

سجل قصير كافٍ لتشخيص معظم حالات الفشل.
التسجيللماذا يساعد
حالة HTTPيفصل بين 401 و 402 على الفور
قيمة okتوضح ما إذا كانت الاستدعاء قد اكتمل
_credits، عند وجودهتوضح الرصيد في وقت الفشل
الإجراء والنطاقيسمح لك بتكرار نفس الاستدعاء عن قصد
وقت الاستدعاءيضعه مقابل التحديث الشهري

لماذا لا إعادة المحاولة التلقائية

التكرار في حالة 402 يهدر الوقت ولا يحقق أي فائدة. التكرار في حالة 401 يمكن أن ينشط كشف الإساءة لدى أي مزود، سواء كان Rankupedia أو Google.

احتفظ بإعادة المحاولة لأخطاء الشبكة، وامنح كل محاولة تأخيرًا أطول من السابقة. ثلاث محاولات هي حد معقول لوظيفة ليلية.

لنفترض أن وظيفة ليلية تواجه خطأ 402 في الثانية صباحًا. إعادة المحاولة كل خمس دقائق حتى وقت الإفطار تنتج حوالي مئة فشل متطابق، وكل منها سطر سجل يجب على شخص ما قراءته لاحقًا.

استخدم حدًا ثابتًا لإعادة المحاولة لأخطاء الشبكة أيضًا، وسجل كل محاولة. الحد الذي يمكنك صياغته في جملة واحدة سهل الدفاع عنه عندما تتوقف الوظيفة.

تنبيهات لوظيفة تعمل دون إشراف

يجب أن تخبر وظيفة فحص نقاط المجال الليلية شخصًا ما عندما تتوقف، ويجب أن توضح السبب. تحتاج الشيفرتان إلى تنبيهات مختلفة، لذا احتفظ بهما منفصلين في الرسالة.

تنبيه على أول خطأ 401

عادةً ما يعني خطأ 401 واحد مشكلة في المفتاح، لذا فإن فشلًا واحدًا يستحق رسالة. الانتظار حتى مئة فشل متطابق يؤخر الإصلاح فقط.

أدرج الحرفين الأول والأخير من المفتاح في التنبيه، وليس المفتاح الكامل، لتكون الرسالة آمنة للمشاركة مع زميل.

يستحق خطأ 402 رسالة خاصة به، لأن علاجه هو إضافة رصيد بدلاً من تغيير المفتاح.

الوظيفة الهادئة ليست بالضرورة وظيفة صحية. احسب التشغيلات التي اكتملت، وليس فقط التشغيلات التي فشلت، ونبه عندما لا يتحرك أي من العددين لدورة كاملة.

تنبيه على انخفاض الرصيد

حدد مستوى التحذير بحيث يغطي باقي التشغيل، وليس عند الصفر. رصيد شبه فارغ عند بدء التشغيل لا يترك مجالًا لإعادة المحاولة.

اقرأ المستوى من _credits في كل استجابة موثقة، بحيث لا يحتاج التحذير إلى طلب إضافي.

ملاحظة حول البيانات القديمة

يتم تحديث زاحفنا وفهرس الروابط الخاص بنا تقريبًا مرة واحدة شهريًا. قد يُظهر الموقع الذي أُطلق مؤخرًا قيمة DR 0، وهذا قراءة صحيحة للقطعة البيانات، لأنها لا تحتوي بعد على مجال رابط للموقع.