💡 إذا كنت بصدد التخلص من جداول البيانات أو لديك نظام تحليلات مناسب، فيمكنك استخدام واجهة التطبيق البرمجية الخاصة بنا لجلب البيانات التي تحتاجها تلقائيًا دون الحاجة إلى استيراد ملف CSV بين الحين والآخر.
💡 ضع في اعتبارك أن واجهة التطبيق البرمجية الخاصة بنا تدعم طريقة GET فقط. هذا يعني أنك لن تكون قادرًا على حذف أو إضافة نطاقات أو أشكال إعلانات باستخدام واجهة التطبيق البرمجية.
الحصول على رمز الوصول
معدل الطلبات هو 1200 طلب في الدقيقة لكل مستخدم. كما يتم تخزين استجابة كل طلب عبر واجهة برمجة التطبيقات (API) لمدة 60 ثانية.
للحصول على رمز وصول (Token)، انتقل إلى صفحة "Settings" (تبويب API) من القائمة الجانبية اليسرى، ثم اضغط على "Generate new token":
❗️ يرجى ملاحظة أن رمز الوصول يمكن عرضه ونسخه فقط عند إنشائه. وبعد ذلك لن يكون متاحا للعرض أو الوصول مرة أخرى.
في صفحة واجهة برمجة التطبيقات (API)، يمكنك أيضا الاطلاع على:
عدد رموز الوصول النشطة لديك حاليا، حيث يمكنك امتلاك ما يصل إلى 5 رموز وصول نشطة في الوقت نفسه.
رابط مباشر لوثائق واجهة برمجة التطبيقات (API).
معلومات جميع رموز الوصول النشطة الخاصة بك، بما في ذلك:
الاسم
الحالة
تاريخ انتهاء الصلاحية (تكون صلاحية كل رمز وصول لمدة سنة واحدة)
تاريخ الإنشاء
تاريخ ووقت آخر استخدام
عنوان بروتوكول الإنترنت (IP)
الدولة
خيار إعادة تسمية كل رمز وصول أو حذفه بشكل منفصل:
ستتلقى إشعارا عبر البريد الإلكتروني كلما اقترب موعد انتهاء صلاحية أحد رموز الوصول الخاصة بك.
قم بتثبيت الرمز المميز في معلمة الرأس هذه التي تسمى 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.