تخط وانتقل إلى المحتوى الرئيسي
جميع المجموعاتأبي
هل لدى HilltopAds أدوات واجهة برمجة التطبيقات للمعلنين؟
هل لدى HilltopAds أدوات واجهة برمجة التطبيقات للمعلنين؟

دليل شامل للعمل مع واجهة برمجة تطبيقات HilltopAds لإنشاء حملاتك الإعلانية وتعديلها وتحسينها.

HilltopAds avatar
بقلم: HilltopAds
تم إجراء هذا التحديث منذ أكثر من أسبوع

ما هي واجهة برمجة التطبيقات (API) وكيفية استخدامها في HilltopAds؟

واجهة برمجة التطبيقات (API) تعني واجهة برمجة التطبيقات. بمصطلحات بسيطة، فهي مجموعة من البروتوكولات والأدوات والأساليب التي تسمح لتطبيقات البرمجيات المختلفة بالتواصل والتفاعل مع بعضها البعض. تُستخدم واجهات البرمجة عادةً لتيسير تبادل البيانات والوظائف بين تطبيقات مختلفة ومنصات وأنظمة.

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

ما هي أساليب الطلب المستخدمة؟

تدعم واجهة برمجة تطبيقات HilltopAds للمعلنين الأساليب GET، PATCH، POST، DELETE، و PUT.

  • تسمح طريقة GET بالحصول على البيانات دون إجراء أي تغييرات.

  • تسمح طريقة PATCH بتحديث البيانات المقدمة في الطلب..

  • تسمح طريقة POST بإنشاء بيانات.

  • تسمح طريقة DELETE بحذف البيانات.

  • تسمح طريقة PUT بتعويض جميع البيانات المقدمة في الطلب.


يُرجى ملاحظة أن طرق PATCH و PUT تعمل بنفس الطريقة، ولكن هناك فرق في عملهما، والذي سيصبح واضحًا من خلال مثال.

لنفترض أن لدينا بيانات {A:1، B:2، C:3}. نحتاج إلى استبدال B:2 بـ B:4.

  • ستقوم طريقة PATCH بتعويض المعلمة B فقط. ونتيجة لذلك، سنحصل على {A:1، B:4، C:3}.

  • ستقوم طريقة PUT بتعويض جميع المعلمات. ونتيجة لذلك، سنحصل على {B:4}.


كيفية إنشاء مفتاح API؟

لبدء العمل مع واجهة برمجة التطبيقات، تحتاج إلى إنشاء مفتاح API الخاص بك. للقيام بذلك:

  • تسجيل الدخول إلى حساب HilltopAds الشخصي.

  • انتقل إلى قسم حسابي.

  • ثم انتقل إلى علامة تبويب الـ API.

  • قدّم وصفًا لمفتاح الـ API.

  • انقر على زر إنشاء مفتاح API.

  • هذا المفتاح هو رمز فريد يرتبط طلب واجهة البرمجة الخاص بك بحسابك ويمكّن الوظيفة من العمل بشكل خاص مع بياناتك.

يُرجى ملاحظة أنه من أجل ضمان عمل طلبات واجهة البرمجة بشكل صحيح، تأكد من أن مفتاح الـ API الذي قمت بإنشائه لديه حالة نشطة.

هل أجاب هذا عن سؤالك؟