افصل بيانات الفهرس عن الطلبات
تعرض API بيانات الروابط ملاحظات فهرس مزود، بينما تنشئ API الطلبات عمليات تجارية أو تسترجعها. استقبال البيانات لا ينشر روابط، وإيصال الطلب لا يكتشف الويب. يتبع المثال تنسيق DataForSEO v3 Backlinks Live. تعالج الأداة ملفًا محليًا بلا مفتاح أو استدعاء مدفوع. النطاقات المحجوزة مثال تعليمي مؤلف وليست نتيجة مسح حقيقي.
تحقق من الاستجابة قبل الصفوف
تفصل وثائق نقطة النهاية الاستجابة والمهمة والطلب والنتائج. تتطلب الأداة مهمة ناجحة واحدة ونتيجة واحدة. الخطأ لا يتحول إلى صفر روابط، ونجاح HTTP وحده لا يكفي. راجع تعريفات الأخطاء. احفظ الوجهة والمرشحات والتجميع. قد يدمج المزود مراجع من الصفحة نفسها، لذا لا يساوي الصف بالضرورة كل عنصر رابط مادي.
اقرأ أربع ملاحظات افتراضية
يعلن الملف تسع نتائج ويقدم أربعًا فقط. الخمس الغائبة ليست روابط ثبت فقدانها. تعرض الصفوف مؤشر follow وخصائص sponsored/nofollow وعلامة فقدان وقيمًا مجهولة. التواريخ ملاحظات تاريخية للمزود. تظل false والصفر والغياب منفصلة، وتحفظ أزواج العناوين المكررة. التحقق من بنية JSON لا يوثق أصل الملف أو صحة ادعاءاته.
| التحقق | حقل أو قيمة افتراضية | التفسير | ما لا نستنتجه |
|---|---|---|---|
| الاستجابة والمهمة | status_code: 20000 في المستويين | بنية نجاح مدعومة | فحص مصادر جديد |
| الإجمالي والمستلم | total_count: 9; items_count: 4 | أربعة سجلات؛ نتيجة جزئية | خمس خسائر أو حصر كامل |
| المصدر والوجهة | url_from; url_to | احفظ زوج العناوين الدقيق | كل صف يعد جميع عناصر الرابط |
| القيم ذات الأنواع | dofollow: false / null | النفي المبلغ والمجهول مختلفان | الغياب يعني follow |
| ملاحظة تاريخية | is_lost: true; last_seen: 2026-10-03 | فقدان بحسب المزود | حذف تحقق اليوم |
| سياق الطلب | mode: as_is; backlinks_status_type: all | احفظ النطاق مع السجلات | نفس الإجمالي مع مرشح آخر |
ضع حدود التكامل قبل الإنفاق
يحتاج التكامل الحقيقي مفاتيح على الخادم وميزانية مصرحًا بها ومعلمات مسجلة. راجع الأسعار والحدود الحالية واحفظ الأصل قبل التحويل. يجب أن تحافظ الصفحات المتتابعة على نطاق الاستعلام، مع مقارنة المستلم بالإجمالي واتباع قواعد المزود. لا تكرر طلبًا مدفوعًا غير محسوم تلقائيًا. علامة الفقدان ليست فحص حذف جديدًا. لا تقدم API Search Console تقرير الروابط، وبيانات الزيارات ليست بديله.
استورد محليًا واحتفظ بالأصل
حمّل المثال أو الصق JSON متوافقًا أو اختر ملف UTF-8. راجع الإجمالي والصفوف وتحذير النتيجة الجزئية والسياق. CSV مناسب للجداول، وJSON يحفظ الأنواع: النص الفارغ والغائب يصيران خليتين فارغتين في CSV. يضاف اقتباس مفرد واقٍ إلى النص الذي يشبه الصيغ. نزّل الوحدة وملف سطر الأوامر والمثال إلى مجلد واحد. أوامر Node.js أدناه لا تستخدم الشبكة. أوراق CSV ملاحظات تفسير وليست مدخلات JSON للأداة.
تنزيل مراجعة API المكتملة · تنزيل مراجعة API الفارغة
node backlink-api-cli.mjs backlink-api-example-ar.json > backlink-api-records.csv
node backlink-api-cli.mjs backlink-api-example-ar.json --json > backlink-api-projection.jsonاعرف حدود المخرجات
تُقبل مهمة واحدة ونتيجة واحدة، وبحد أقصى ألف عنصر و512 KiB. بيانات الطلب الوصفية المختارة محدودة بألفي محرف. لا تُصدّر كل حقول المزود؛ احتفظ بالأصل. لا تتحول التواريخ إلى تواريخ نشر، ولا تُجلب صفحات المصادر أو تُدمج ملفات الصفحات أو تُوثق الحسابات. الاستجابة الفارغة الصحيحة تصف نطاقها فقط. النشر الحالي والوصول والفهرسة والترتيب تحتاج أدلة مستقلة.