أداة الروابط الخلفية لم تُرجع شيئًا: جدول الأخطاء

القاعدة التي تغطي معظم الحالات

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

يحمل كل استجابة JSON حقل ok، وتضيف الاستجابات المصادق عليها _credits مع تكلفة المكالمة والرصيد المتبقي. تحقق من ok في الجسم حتى عندما يبدو وضع HTTP جيدًا.

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

لماذا لا يتم إعادة المحاولة مع 401 و402

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

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

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

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

أخطاء الشبكة والتراجع

يمكن أن يتلاشى الوقت المستغرق أو إعادة تعيين الاتصال بمفرده، لذا فهذه هي الحالات الوحيدة التي تستحق محاولة أخرى. انتظر 1، 2، 4 ثم 8 ثوانٍ، أضف بعض الاهتزاز، وتوقف بعد المحاولة الرابعة.

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

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

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

طوّر النطاق قبل المكالمة

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

انزع المخطط والمسار

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

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

اختبر التنظيف بـ 5 أو 6 مدخلات حقيقية منسوخة، بما في ذلك واحدة مع شرطة مائلة في النهاية وواحدة مع سلسلة استعلام. تظهر هذه الحالات الأخطاء التي لا تظهرها أي مثال نظيف.

قرر مرة واحدة ماذا تفعل مع www.

اختر قاعدة واحدة لـ www. وطبقها في دالة واحدة، حتى لا يتم البحث عن نفس الموقع تحت تهجئتين مختلفتين.

اكتب القاعدة بجانب الدالة. المطور التالي الذي يلتقي بـ www الغريب سيجد القرار، وليس رأيًا ثانيًا.

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

ارفض ما لا يمكن أن يكون نطاقًا

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

النقاط في النهاية هي الحالة الغريبة. انزع واحدة في نهاية المضيف وعامل أي شيء آخر على أنه غير صالح.

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

النتائج الفارغة وعمر الفهرس

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

موقع جديد تمامًا

قد لا يكون للموقع الذي تم إطلاقه الأسبوع الماضي أي روابط خلفية في الفهرس. اعرض "لم يتم فهرسته بعد" مع تاريخ الفهرس، وقدم مكالمة overview المجانية كاختبار متقاطع.

لا تخزن هذه الإجابة الفارغة لفترة طويلة. بضع ساعات كافية، وقد يجلب البناء التالي الموقع.

أخبر الزائر متى تم إعادة بناء الفهرس آخر مرة، بكلمات واضحة. التاريخ بجانب الإجابة الفارغة يفسر الفجوة بشكل أفضل من رسالة أطول.

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

رقم يختلف عن أداة أخرى

ترى الزواحف المختلفة شرائح مختلفة من الويب. اقرأ رقم DR كموضع داخل أداة واحدة، وأرشد القراء إلى مرجع DR للصيغة.

ملاحظة قصيرة تحت الرقم توفر وقت دعم أكثر من أي اعتذار بعد الحادثة.

إذا اختلفت قراءتان، قارن عدد النطاقات المرجعية أولاً. صيغة DR بسيطة، لذا فإن معظم الخلافات تعود إلى العدد.

الصفوف التي تتوقف عند 50,000

عندما تتوقف القائمة عند الحد، فإن الإجابة صحيحة لما تسمح به API. حدد القطع واربط ملاحظات التصفح بدلاً من محاولة صفحة أعمق.

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

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

إظهار عدد الصفوف بجانب الجدول يحول القطع إلى حقيقة مرئية. القارئ الذي يرى 50,000 صف يعرف أنه يطلب سؤالًا أضيق.