💡 إذا كنت بصدد التخلص من جداول البيانات أو لديك نظام تحليلات مناسب، فيمكنك استخدام واجهة التطبيق البرمجية الخاصة بنا لجلب البيانات التي تحتاجها تلقائيًا دون الحاجة إلى استيراد ملف CSV بين الحين والآخر.
💡 ضع في اعتبارك أن واجهة التطبيق البرمجية الخاصة بنا تدعم طريقة GET فقط. هذا يعني أنك لن تكون قادرًا على حذف أو إضافة نطاقات أو أشكال إعلانات باستخدام واجهة التطبيق البرمجية.
الحصول على رمز الوصول
للحصول على رمز الوصول، انتقل إلى صفحة واجهة التطبيق البرمجية API من القائمة اليسرى وانقر فوق إنشاء رمز جديد. يمكنك أيضًا الوصول إلى وثائق API من تلك الصفحة وإيجاد جميع الرموز التي استخدمتها من قبل.
❗ لاحظ أنه لا يمكن أن يكون هناك سوى رمز واحد صالح في كل مرة. لذلك بمجرد إنشاء رمز جديد، يجب عليك إجراء تغيير على جميع طلبات API التي قمت بها.
قم بتثبيت الرمز المميز في معلمة الرأس هذه التي تسمى x-api-key:
نقاط النهاية ومعرف الموارد الموحد (URI) المتاحة
يتم إرسال جميع الطلبات إلى URI التالي:
<https://api3.adsterratools.com/publisher//>
ستجد أدناه قائمة بنقاط النهاية المتاحة:
domains/{format}/ — تعرض مواقع الويب التي أضفتها إلى أدستيرا، بما في ذلك أسماءها ومعرفاتها الوحيدة؛domain/{domain_id}/placements.{format}/ — مواضعك في النطاق المحدد؛ لاحظ أنك ستحتاج إلى استرداد domain_id عبر الطلبdomains/{format}/ أولاً؛placements.{format}/ — تعرض القائمة الكاملة للمواضع الخاصة بك؛stats.{format}/ — تقرير يتضمن مرات الظهور والنقرات ونسبة النقر إلى الظهور والتكلفة لكل ألف ظهور والأرباح حسب التاريخ؛ يمكنك تحديد domain_id, placement_id وتواريخ البدء والانتهاء، بالإضافة إلى موقع جغرافي محدد.
يمكن استرداد البيانات بتنسيق JSON و XML و CSV. تأكد من تحديد تنسيق البيانات الذي تحتاجه في URI:
<https://api3.adsterratools.com/publisher/domains.json>
مثال للطلبات حول كيفية الحصول على إحصائيات أدستيرا عبر واجهة التطبيق البرمجية API
سنوجهك خلال بعض الطلبات باستخدام Postman وهي أداة اختبار API شائعة. يمكنك استخدامها للحصول على فكرة عن كيفية تنسيق البيانات واختبار الطلبات التي تخطط لتقديمها.
أولاً، نحتاج إلى الحصول على معرّفات النطاقات الخاصة بنا من URI التالي:
<https://api3.adsterratools.com/publisher/domains.json>
يمكننا أن نرى في نص الإجابة ما يلي:
دعنا نجد placement_id's من موقع الويب الأول (domain_id 1385226)
الآن، يمكننا استخدام domain_id و placement_id لجلب إحصائيات هذا الموضع:
الإجابة
الأخطاء المحتملة وطرق إصلاحها
401 — الرمز غير صحيح. الرجاء استخدام الرمز المتاح في لوحة القيادة الخاصة بك.
403 — لم يعد الرمز صالحًا. الرجاء إنشاء رمز جديد.
404 — غير موجود. تأكد من صحة URI.