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

مرجع

مرجع واجهة برمجة تطبيقات الروابط الخلفية: الإجراءات، التكاليف والأخطاء

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

جسر حجري فوق نهر مع قارب صغير يبحر تحته

الإجراءات حسب تكلفة الرصيد

1 رصيد = $0.0001. يتم احتساب تكلفة كل استدعاء مرة واحدة بغض النظر عن عدد الصفوف، حتى 1,000 صف لكل استدعاء.
التكلفةالإجراءاتملاحظات
مجاني، بدون مفتاحdomain، overview، stats، suggestمناسب للوحات المعلومات وفحص DR
1 رصيدbulk_dr، compare، top، dr_distribution، tld_breakdownيأخذ bulk_dr ما يصل إلى 2,000 نطاق (GET domains= أو POST body)؛ compare ما يصل إلى 20
2 رصيدrefdomains، backlinks، anchors، toppages، anchor_cloud، intersectيأخذ intersect من 2 إلى 10 نطاقات
3 رصيدsearch، keywordبحث نصي كامل عبر المراسي والعناوين وروابط URL؛ يجد keyword من يتم ربطه بنص مراسي دقيق

المصادقة ورموز الحالة

مرر المفتاح كـ key= أو كعنوان حامل. تحقق من رمز HTTP قبل تحليل الجسم.

bash
# header style
curl -s -H "Authorization: Bearer sk_live_..." \
  "https://seouptr.com/api.php?action=anchors&q=yourdomain.com&per=100"

# a cron-safe wrapper
code=$(curl -s -o out.json -w '%{http_code}' "$URL")
case "$code" in
  200) jq '._credits' out.json ;;      # cost and remaining balance
  401) echo 'bad or missing key' ;;
  402) echo 'out of credit: top up' ;;
  *)   echo "unexpected $code" ;;
esac

المعاملات والأخطاء

العنصرالقيمةالمعنى
qنطاقهدف البحث
page، perper من 10 إلى 5000التصفح؛ عدد الصفوف لكل استدعاء محدود بـ 1,000، والتصفح العميق محدود بـ 50,000
sort، orderorder=asc أو descترتيب الصفوف المعادة
okفي كل استجابةما إذا كان الاستدعاء قد نجح
_creditsفقط الاستجابات المصادق عليهاتكلفة الاستدعاء والرصيد المتبقي
HTTP 401مفتاح مفقود أو غير صالحتحقق من المفتاح أو العنوان
HTTP 402نفد الرصيدأضف رصيدًا باستخدام USDT (TRC-20)
نجار يقيس الخشب ويختار الأدوات على طاولة ورشة

تصميم الاستدعاء قبل جدولته

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

احتفظ بالمفتاح خارج النص البرمجي

احفظ المفتاح في متغير بيئة أو متجر أسرار، وليس في ملف تقوم بإيداعه. مرره كمعامل key أو كعنوان حامل. يحافظ العنوان على المفتاح خارج عناوين URL التي تميل إلى الانتهاء في السجلات.

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

اختر حجم الصفحة عن قصد

يعمل معامل per من 10 إلى 5000، ولكن يتم احتساب تكلفة الاستدعاء مرة واحدة حتى 1,000 صف، لذا فإن الصفوف الأكبر تعني رسومًا أقل. لنفترض أنك تحتاج إلى 3,400 صف. هذا يتطلب أربعة استدعاءات بـ 1,000 صف، وليس 340 استدعاءً بـ 10.

حافظ على حجم الصفحة ثابتًا عبر التشغيلات بحيث تتطابق الملفات.

ثبت ترتيب الترتيب

عيّن sort و order بشكل صريح بدلاً من الاعتماد على القيمة الافتراضية. تجعل المعاملات المتطابقة المخرجات قابلة للمقارنة من أسبوع لآخر، بحيث يظهر الاختلاف التغيير الحقيقي وليس الصفوف المعاد ترتيبها.

تغيير الترتيب طريقة سهلة لإنشاء إنذارات كاذبة.

قراءة الأرقام

البيانات هي رسم بياني للروابط الخاص بنا: 181,132,097 نطاق، و2,774,625,913 رابط بين النطاقات، وحوالي 798.5 مليار رابط خلفي. يتم تحديثها تقريباً مرة واحدة شهرياً. أي بيانات أحدث من ذلك لن تكون موجودة فيها، ولهذا السبب يُفضل استهلاك seo backlinks api أسبوعياً.

DR هي round(100 · log(ref_domains+1) / log(2·10^7)). إنها دالة لوغاريتمية. بسبب ذلك، فإن 100 نطاق مرجعي يحصل على درجة 27، و1,000 يحصل على 41، و10,000 يحصل على 55، لذا فإن مضاعفة عدد الروابط تضيف فقط بضع نقاط. استخدم DR لترتيب المواقع ضد بعضها البعض والعدد الخام للتنبيهات، كما تفعل جدول الشدة.

التسعير مسبق الدفع. لا يوجد اشتراك ولا حد أدنى. رصيد التسجيل هو $100، وهو ما يعادل 1,000,000 رصيد. قارن ذلك بوحدات Ahrefs API، المباعة ضمن خطط تبدأ من $129/شهر مقابل 200,000 وحدة، مع حد أدنى 50 وحدة لكل طلب.

تخطيط التكلفة ضرب بسيط. استدعاء refdomains أسبوعياً لموقع واحد هو 2 رصيد مضروباً في 4، أو 8 أرصدة شهرياً، وهو ما يعادل $0.0008. عشرة مواقع تكلف عشرة أضعاف ذلك. وصفة فقدان الرابط ووظيفة المنافس كلاهما يستخدمان فقط إجراءات من الجدول أعلاه.

قراءة الخطأ دون تخمين

رمز الخطأ يخبرك من يجب أن يتصرف. اقرأه بهذه الطريقة. يصبح الاستجابة قراراً بالتوجيه، وليس لغزاً. الرمزان الأكثر أهمية للمراقب هما 401 و 402.

401 و 402 مشكلتان مختلفتان

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

أرسل كلاهما إلى شخص. المراقب الذي يفشل بصمت أسوأ من الذي لم يعمل أبداً.

فحص الحالة قبل المحتوى

اقرأ حالة HTTP أولاً وحقل ok ثانياً. يمكن تحليل الاستجابة كـ JSON ولا تزال تحمل خطأً، لذا لا تكون الفحص مكتملاً إلا عندما ينجح الاثنان. سجل الحالة مع كل تشغيل، حتى الناجحة منها.

أعد المحاولة فقط فيما يمكن أن يتعافى

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

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

سجل الحالة في كل تشغيل

اكتب حالة HTTP والرصيد في السجل في كل تشغيل، بما في ذلك الناجحة منها. عندما يفشل تشغيل بعد ثلاثة أسابيع، سيكون هذا السطر هو أول ما تريد رؤيته.

الإجراءات المجانية أولاً

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

قبل أن تضع استدعاء في cron

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

ملاحظات حول التصفح

الترتيب مهم. استخدم per=1000 للقطات الاحتياطية واحتفظ بنفس sort و order كل أسبوع. إذا تغير الترتيب بين التشغيلات، يظهر الاختلاف ضوضاء. هذا سبب كلاسيكي للإنذارات الكاذبة.

مواقع أكبر؟ لموقع يحتوي على أكثر من 1,000 نطاق مرجعي، تصفح باستخدام page=1، page=2 وهكذا. كل صفحة هي استدعاء مفرد محاسب. التصفح العميق محدود بـ 50,000 سطر، وهو ما يغطي تقريباً كل موقع عادي.

أسئلة حول المرجع

أي إجراء يجب أن أستدعيه أولاً عندما لا أكون متأكداً من مظهر النطاق؟
ابدأ بـ overview أو domain. كلاهما مجاني ولا يحتاج إلى مفتاح، ويظهر حجمًا تقريبيًا والشكل الأساسي للبيانات. أنفق أرصدة على refdomains أو anchors فقط بعد ذلك.
كم يكلف الفحص الكامل لنطاق واحد؟
اجمع أرصدة كل إجراء، ثم اضرب في عدد المرات التي يعمل فيها. تخيل استدعاء refdomains، واستدعاء anchors واستدعاء tld_breakdown على نطاق واحد، أسبوعياً. هذا 2 + 2 + 1 = 5 أرصدة في التشغيل، أو $0.0005. على مدار أربعة أسابيع، يصل إلى حوالي $0.002.
لماذا قد لا تتطابق عددين لنفس النطاق؟
قارن المتشابه مع المتشابه: نفس الإجراء، نفس المعاملات ونفس فترة التحديث. الأرقام من إجراءات مختلفة ليست قابلة للتبديل، وقد يختلف الرقم المأخوذ أثناء التحديث عن رقم مأخوذ بعد أسبوع.
كيف أختبر مهمة cron دون إنفاق أرصدة؟
شغل الإجراءات المجانية أولاً للتحقق من الأسلاك، ومعالجة الحالة وتنسيق المخرجات. ثم قم باستدعاء مدفوع واحد لإثبات الأرقام، وحد المهمة في تشغيل واحد أثناء الاختبار.
هل يعمل التصفح لموقع يحتوي على أكثر من 1,000 نطاق مرجعي؟
نعم. استخدم page مع per. كل صفحة هي استدعاء مفرد محاسب، والتصفح العميق محدود بـ 50,000 سطر، وهو ما يغطي معظم المواقع العادية.

مراقب يتحمل أسبوعاً سيئاً

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

أخطاء المهلة والسحب الجزئي

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

علّم الملف الجزئي كملف جزئي بدلاً من حفظه كلقطة عادية. خلاف ذلك، سيظهر الاختلاف التالي خسارة لم تحدث أبداً.

فحوصات الرصيد

اقرأ _credits في كل استجابة موثقة واكتب الرصيد المتبقي في السجل. يمكن لبرنامج نصي صغير مقارنته بحد أدنى تختاره وإرسال تحذير قبل التشغيل التالي.

قل إن الحد الأدنى هو 500 رصيد. تشغيل أسبوعي يكلف 40 رصيد يترك مجالاً لإضافة رصيد قبل وصول 402 في منتصف الليل.

اجعل كل مهمة مملة

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

طابق الجدول مع التحديث

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