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

العرض، السبب، الإصلاح
| ما تظهره المحادثة | ما حدث | الإصلاح |
|---|---|---|
| "تعذر استرداد البيانات" بدون تفاصيل | على الأرجح HTTP 401. المفتاح مفقود، أو كُتب بشكل خاطئ، أو ألصق مع وجود مسافة في النهاية. | أعد لصق المفتاح. اختبره باستخدام الإجراء المجاني overview في طرفية الأوامر. |
| كان يعمل بالأمس، "الخدمة غير متاحة" اليوم | على الأرجح HTTP 402. وصل الرصيد إلى الصفر بعد حلقة تكرار أو جلسة طويلة. | أضف رصيداً باستخدام USDT (TRC-20) من صفحة الحساب. لا تزال الإجراءات المجانية تعمل. |
| تقييم 0 أو عدم وجود صفوف لموقع حقيقي | قد لا يحتوي الفهرس على النطاق بعد، أو تم إرسال الاسم مع مسار أو https://. | أرسل النطاق المجرد. أعد المحاولة الشهر القادم إذا كان الموقع جديداً جداً. |
| الرابط الجديد الذي بنيتَه مفقود | يتم تحديث الفهرس مرة واحدة تقريباً شهرياً. | انتظر التحديث. لا تقم بتشغيل الاستدعاء عشر مرات. |
| الأرقام تختلف عن لوحة تحكم مورد آخر | مكشافات مختلفة وتقييمات مختلفة. DR الخاص بنا هو مقياس خاص به. | قارن الاتجاهات، وليس الأرقام الفردية. |
| يحتوي الرد على عدد صفوف أقل بكثير مما هو متوقع | حدد المخطط per، أو قرأ المساعد الصفحة الأولى فقط. | اطلب page=2 صراحةً. |
يحتوي الرد على أرقام ولكن لا يحتوي على _credits | لم يتم إجراء أي استدعاء. أجاب النموذج من الذاكرة. | طبق القواعد في دليل تشغيل الأوامر. |
| رسوم أعلى مما خططت له | أعاد المساعد محاولة إجراء مدفوع، أو كرر حلقة عبر قائمة. | حدد عدد مرات إعادة المحاولة بواحدة فقط، وادمج الطلبات باستخدام bulk_dr. |
لماذا يهم رمز الحالة أكثر من الجملة
يحول المساعد 402 إلى فقرة مهذبة. تقرأ الفقرة، وليس الرمز. اطلب الحالة الخام. إنها أرخص تشخيص لديك.
قسّم العطل إلى جزأين. قبل أن تلوم النموذج، شغل نفس الرابط في طرفية الأوامر. إذا أرجعت curl JSON مع ok صحيح، فإن الواجهة البرمجية تعمل بشكل جيد والعطل في الغلاف أو الأمر. إذا فشلت curl أيضاً، فالمفتاح أو الرصيد هما المشكلة، ولن يصلح أي صياغة للأمر ذلك.
تسعين ثانية من الفرز
- شغل الاستدعاء الفاشل مع curl وإجراء مجاني. هل يعود
ok؟ - شغله بإجراء مدفوع. يشير 401 إلى المفتاح، و402 إلى الرصيد.
- اطبع النطاق بالضبط كما أرسله المساعد. ابحث عن
www.، المسارات والعلامات الاقتباسية. - تحقق من تاريخ طلبك الأخير مقابل التحديث الشهري.
- اقرأ سجل استدعاء الأداة لمنتج المساعد الخاص بك، وليس ملخصه.

عند توقف نص برمجي في المنتصف
البرامج النصية هي المكان الذي ينمو فيه الفاتورة بصمت. الحالات الثلاث أدناه توضح كيف يتحول توقف، أو سلسلة، أو خطأ صامت إلى استدعاءات أكثر مما خططت له.
يمكن أن يترك Ctrl-C دفعة منجزة جزئياً
تتكرر العديد من البرامج النصية عبر قائمة من النطاقات وتقوم بإجراء مدفوع واحد لكل عنصر. اضغط Ctrl-C في المنتصف. الاستدعاءات التي تمت بالفعل تُفوت، والباقي لا يحدث. يجب أن تقول ملف الإخراج أي النطاقات انتهت.
اكتب كل نتيجة على القرص بمجرد وصولها. ثم يمكن لإعادة التشغيل تخطي النطاقات التي انتهت بالفعل بدلاً من دفع ثمنها مرتين.
تعدد البرامج النصية يضاعف الاستدعاءات
تشغيل ثلاثة برامج نصية ودمج مخرجاتها في بريد إلكتروني واحد يبدو مرتباً. لنفترض أن كل برنامج نصي من الثلاثة يقوم باثنين من الإجراءات المدفوعة، وتشغيل واحد ينفق ستة. احسب أولاً، ثم جدول.
برنامج نصي واحد يجمع البيانات مرة واحدة، ثم ينسقها، يبقي الفاتورة والمنطق في مكان واحد. يجب أن يطبع البرنامج النصي المجدول عدد استدعاءاته في النهاية، بحيث يكون لدى الشخص الذي يتحقق من الرصيد رقماً للمطابقة معه.
اقرأ جسم الخطأ قبل إعادة التشغيل
عادةً ما يعيد الاستدعاء الفاشل جسمًا يحتوي على ok مضبوطاً على false ورسالة قصيرة. اقرأ الرسالة أولاً. إعادة التشغيل بنفس المفتاح ونفس الرصيد ستفشل بنفس الطريقة.
البرامج النصية التي تبتلع الجسم وتطبع فقط كلمة failed تضيع التلميح الوحيد الذي كان لديك. اقتبس الحالة والرسالة كما جاءت. إعادة الصياغة من قبل المساعد فقدت بالفعل التفاصيل التي كانت ستساعد. حرفياً، دائماً.
أخطاء وإصلاحات في الغلاف نفسه
نفس الأخطاء الثلاثة تظهر في معظم الأغطية. وضع المفتاح في الرابط يعني ظهوره في السجلات وفي النصوص المشتركة، لذا استخدم رأس bearer حيث يسمح منتجك بذلك.
كشف كل إجراء هو الثاني. يحتاج GPT الخاص بك إلى أربعة إجراءات فقط، وكل إجراء إضافي هو طريقة أخرى لإنفاق رصيد لم تخطط له. الثالث هو طلب 5,000 صف بينما الرد يستخدم عشرة.
أصلحها مرة واحدة وتتوقف معظم الجدول أعلاه عن التطبيق. الأرقام الخاطئة التي تبقى بعد كل ذلك مغطاة في صفحة الأساطير.

إعداد سجل استدعاء يظهر الفشل
السجل هو أرخص تشخيص ستشتريه أبداً. لا يكلف شيئاً للحفاظ عليه، ويحول شكوى غامضة حول المحادثة إلى قائمة من رموز الحالة يمكنك عدها. عادة واحدة كافية.
سطر واحد لكل استدعاء، مع الحالة
اكتب الطابع الزمني، والإجراء، والنطاق، وحالة HTTP وقيمة _credits على سطر واحد. النص العادي كافٍ. يمكن لجدول بيانات قراءته لاحقاً، وسجل من الحالات يظهر نمطاً تخفيه رد واحد من المحادثة.
احتفظ بالاستدعاءات المجانية والمدفوعة في أعمدة منفصلة، حتى لا يختفي ارتفاع الأخطاء المدفوعة في المجموع. حدد أي استدعاء تمت إعادة محاولة، واحتفظ بعدد إعادة المحاولة بجانب الأصلي. تكرار 402 في نفس الساعة يشير إلى حلقة، وليس يوم سيئ. اقرأ السجل أولاً. لوم النموذج في النهاية.
تنبيه على الحالة، وليس النبرة
يمكن أن تبدو نافذة المحادثة هادئة بينما يظهر السجل 402 في كل صف. ضع قاعدة لرموز الحالة التي تهمك. اجعلها مملة. 401 يعني المفتاح، 402 يعني الرصيد، وأي شيء آخر يعني قراءة الجسم.
الإجراءات المجانية لا تزال تجيب بينما تفشل المدفوعة هي إشارة واضحة. الرصيد هو السبب المحتمل. الإضافة وإعادة المحاولة تأتي أولاً. الإجراءات المجانية أيضاً تعمل كتحكم، لأنها تظهر أن المسار نفسه لا يزال يعمل.
إعادة إنتاج استدعاء فاشل في خمس خطوات
اعمل من الخارج إلى الداخل. كل خطوة تستبعد طبقة واحدة، بحيث ينتهي العطل في مكان واحد.
- 1
انسخ الرابط الدقيق
خذ الطلب الذي أرسله مساعدك أو نصك البرمجي، بايت تلو الآخر، بما في ذلك النطاق وكتابته. المسافات المخفية و
https://الغريب هي المتسبب الشائع. - 2
شغل إجراء المراجعة المجاني
أرسل نفس النطاق إلى
overview، الذي لا يحتاج إلى مفتاح. إذا أجاب بـokصحيح، فإن المسار والنطاق على ما يرام، والمشكلة تكمن في المفتاح أو الرصيد. - 3
شغل الإجراء المدفوع بالمفتاح
كرر الاستدعاء المدفوع بالمفتاح في الرأس، كما يوصي إعداد GPT المخصص. يشير 401 إلى المفتاح، و402 إلى الرصيد.
- 4
قارن الصف الأول
تحقق من أن الصف الأول المعاد يطابق نفس الاستدعاء الذي تم في طرفية الأوامر. عدم التطابق يعني أن الغلاف غير شيئاً في الطريق.
- 5
اكتب النتيجة
احتفظ بالحالة، والإجراء، والنطاق وقيمة
_creditsمعاً. الشخص التالي الذي يقرأ السجل سيعرف ما حدث دون سؤال.
تمييز النتيجة الفارغة الحقيقية عن النتيجة المعطلة
نوعان من الرد يبدوان متشابهين في نافذة المحادثة ويعنيان أشياء مختلفة جداً. ميز بينهما أولاً. تغيير الشيء الخاطئ يكلف الوقت وأحياناً الرصيد.
صفوف صفر هي إجابة
يمكن أن يعود النطاق بـ ok صحيح وقائمة فارغة. هذا نتيجة حول الفهرس. ليس خطأ في الاستدعاء. قد يكون موقع جديد، أو عدم تطابق في الكتابة، أو رابط لم يصل بعد إلى التحديث الشهري.
عاملها كنتيجة. أبلغ عنها في جملة واحدة. احتفظ بقائمة قصيرة من النطاقات التي عادت فارغة، مع تاريخ كل استدعاء. إذا بقي نفس النطاق فارغاً لمدة شهر، فإن الكتابة هي المشتبه به التالي، ولا يمكن للتحديث الشهري تفسير كل شيء.
عدد قليل جداً من الصفوف هو إعداد
أحياناً يكون الرد قصيراً لأن المخطط حدد الصفوف، أو لأن النص البرمجي قرأ الصفحة الأولى فقط. يتم فوترة الاستدعاء مرة واحدة بغض النظر عن عدد الصفوف، لذا فإن per أكبر في الطلب لا يكلف رصيداً إضافياً. تحقق من الحد في مخططك أولاً. ابدأ من هناك.
اطلب الصفحة الثانية عن قصد، واذكر ذلك في الأمر، بدلاً من الأمل في أن يلاحظ المساعد وجود المزيد.
إجابات سريعة
- هل أداة فحص الروابط الخلفية هي نفسها أداة تتبع الترتيب؟
- لا. تقرأ الروابط: النطاقات المرجعية، النص المرسب، الصفحات الأعلى وتقييم 0-100. أوضاع الكلمات الرئيسية والتكشاف اليومي تخص Ahrefs أو Semrush، وهي منتجات أكثر اكتمالاً لذلك العمل. استخدم كل منها حيث يكون قوياً.
- كم عدد الصفوف التي يمكن أن يعيدها استدعاء واحد؟
- حتى 1,000 صف لكل استدعاء، مع
pageوper(10 إلى 5000) للترقيم، والترقيم العميق محدود بـ 50,000. يتم فوترة الاستدعاء مرة واحدة بغض النظر عن عدد الصفوف، لذا فإنperأكبر لا يكلف أكثر. - لماذا يختلف DR الخاص بي عن Ahrefs؟
- تقييمنا هو round(100 log(ref_domains+1) / log(210^7))، مقياس لوغاريتمي على النطاقات المرجعية. DR الخاص بـ Ahrefs هو مقياس منفصل بطريقته الخاصة. متشابه في الروح، ولكن ليس نفس الرقم أبداً.