API هي واجهة برمجة للتفاعل مع قاعدة بيانات منصة eBay. بعد تنفيذ API ، سيتمكن تطبيقك من توفير واجهة مخصصة أو وظائف أو عمليات متخصصة غير متوفرة في واجهة eBay.
كيفية الحصول على مفتاح eBay API
منذ عام 2017 ، توفر eBay واجهة برمجة التطبيقات المفتوحة ، مما يعني أنها مجانية ومتاحة للجميع. على الرغم من أنه سيتعين عليك الانتظار حتى يقوم فريق eBay بفحص حسابك والموافقة عليه بعد التسجيل ، للوصول إلى حساب مطور eBay الخاص بك. علاوة على ذلك ، لتتمكن من استخدامه في مرحلة إنتاج تطبيقك ، يجب أن تكون مؤهلاً لقواعد الوصول إلى eBay API.
الخطوة 1 – قم بإنشاء حسابانتقل إلى بوابة مطوري eBay وانتقل إلى علامة التبويب تسجيل. لاحظ أنه لا يمكنك استخدام حساب بائع eBay الخاص بك لتسجيل الدخول.
املأ استمارة التسجيل. لاحظ أن اسم المستخدم يجب أن يكون فريدًا. اختر بلدك من القائمة المنسدلة. لا تنس قراءة اتفاقية API والتأكيد عن طريق تحديد المربع. اجتياز التحقق وانقر فوق انضمام.
الخطوة 2 – قم بتأكيد عنوان البريد الإلكترونياتبع رابط التأكيد المرسل إلى بريدك الإلكتروني من منصة eBay تلقائيًا لإنهاء عملية التسجيل.
في النافذة المفتوحة ، سترى إشعارًا يفيد بأن تسجيلك قيد المراجعة خلال يوم عمل واحد على الأقل ويطلب منك انتظار الموافقة حتى يتم منحك حق الوصول.
كيفية استخدام eBay API
بعد أن تحصل على حق الوصول إلى حساب المطور الخاص بك ، ستتمكن من إنشاء مفاتيح API. هذه المفاتيح هي معرفات فردية تخبر منصة eBay عن المطور والتطبيق الذي يجري المكالمات. يمكن إنشاء المفاتيح واستردادها في صفحة حسابي. أنت حر في إنشاء تطبيقك باستخدام مفتاح API eBay بعد تسجيل الدخول إلى حسابك بنجاح.
توفر المنصة مجموعة واسعة من الحلول التي تنقسم إلى فئات رئيسية: الشراء والبيع والتجارة وغيرها. كل هذه الأشياء يمكن استخدامها بحرية من قبل أي شخص لديه حساب مطوري eBay ، ولكن فقط على أداة اختبار eBay API – بيئة اختبار Sandbox . لكي تتمكن من استخدامها ، يجب على المستخدم تقديم طلب للوصول إلى الإنتاج عبر eBay Partner Network. لهذا السبب نوصيك بشدة بإكمال عملية طلب الإنتاج والحصول على الموافقة قبل أن تستثمر بشكل كبير في تطوير التطبيق واختباره.
أمثلة eBay API
يستعرض eBay api
يتميز قسم eBay Trading API بمكالمات GetFeedback و LeaveFeedback التي يمكن أن يستخدمها البائع لاسترداد تقييماته ومن قبل المشتري لترك ملاحظات البائع على التوالي.
واجهة برمجة تطبيقات تغذية منتج eBay
يعد هذا النوع من واجهة برمجة التطبيقات جزءًا من حلول Buy API ومتاح في وضع Beta وللشركاء المؤهلين فقط (اقرأ كيف تصبح واحدًا في القسم السابق من هذه المقالة). تهدف هذه المجموعة من واجهات برمجة التطبيقات إلى إنشاء تجارب شراء في تطبيقك أو موقع الويب الخاص بك ، وخلاصة المنتج هي بالتأكيد جزء منها.
يتميز Feed API بالإمكانيات التالية
| يكتب | وصف | استعلامات عينة |
| العنصر | يقوم بإرجاع ملف تغذية العنصر اليومي للعناصر المدرجة حديثًا لفئة معينة ، وتاريخ ، وإرجاع السوق أسبوعيًا ، ملف Bootstrap لتغذية العناصر ، الذي يحتوي على جميع العناصر في فئة معينة وسوق معين |
(feed_scope = NEWLY_LISTED)
(feed_scope = ALL_ACTIVE). |
| item_group | يُرجع ملف مجموعة العناصر يوميًا لمعلومات تباين العنصر للعناصر الموجودة في ملف موجز العناصر اليومي أو ملف موجز تمهيد مجموعة العناصر الأسبوعي الذي يحتوي على معلومات التباين للعناصر الموجودة في ملف موجز تمهيد تشغيل العنصر |
(feed_scope = NEWLY_LISTED)
(feed_scope = ALL_ACTIVE). |
| item_snapshot | لعرض ملف gzip كل ساعة للعناصر التي تم تغييرها في فئة وسوق في تاريخ وساعة محددين. | category_id = سلسلة snapshot_date = سلسلة |
eBay messaging API
تهتم المنصة بالبيانات الشخصية لمستخدميها ولديها عائلة مطورة من مكالمات واجهة برمجة التطبيقات للاتصال. يمكن العثور على الوصف الكامل في قسم مكالمات المراسلة . هذا مثال لإعطائك فكرة عن مدى تعقيدها:
- تطبيق أو موقع ويب يسرد عنصرًا للبيع. و ItemID تم إرجاعها من القائمة.
- يسأل المشتري البائع سؤالاً حول العنصر المدرج باستخدام موقع eBay. تم تعيين MessageType لهذه الرسالة داخليًا على
AskSellerQuestion. - منصة eBay تخزن الرسالة.
- يغادر تطبيق Item.ListingDetails.HasUnansweredQuestions و Item.ListingDetails.HasPublicMessages ل ItemID .ثم يدعو GetMemberMessages لاسترداد MessageID الصورة من أي رسائل غير مجاب ل ItemID .
- في حالة وجود أية رسائل غير مقروءة ، يقوم أحد التطبيقات باسترداد MessageID حتى يتمكن من الرد عن طريق نشر رسالة إلى الموقع.
- هناك تطبيق يدعو AddMemberMessageRTQ ، وبالتالي يوفر للبائع خيار نشر السؤال وإجابته الخاصة ليراها الجميع على المنصة ، أو إرسال نسخة من البريد إلى عنوان بريده الإلكتروني الشخصي.
eBay shipping API
تعد Logististics API جزءًا من واجهات برمجة تطبيقات البيع وتتيح للبائعين تسهيل عملية تسليم الطلبات من خلال تقديم ملصقات الشحن لمجموعة من خدمات الشحن ، والتي يتم تسعيرها جميعًا بأسعار الشحن المتفاوض عليها من eBay. باستخدامه يمكنك إنشاء واسترداد الشحنات بناءً على تفاصيل السعر المحدد أو الإلغاء ، إذا لم تكن قد استخدمتها.
موقع ئي باي التابع لواجهة برمجة التطبيقات
تعمل شبكة شركاء eBay مثل أي برنامج تابع آخر. يمكنك الانضمام إلى شريك بوابة موقع ئي باي ، وتوليد الروابط التابعة لها وكسب لجنتكم. يصل الشركاء إلى النص البرمجي لواجهة برمجة التطبيقات التابعة لـ eBay على غرار أي مستخدم آخر لديه حساب مطور ، مع الاختلاف الوحيد الذي يتمثل في أن هذه الاستدعاءات تتضمن معرّف حملة فريدًا. يربط هذا المعرف حركة المرور الخاصة بك بحساب الشريك ، لذلك يتم الدفع للشركاء مقابل المعاملات المؤهلة.
التسعير والحدود
تدعم الخدمة آلاف التطبيقات وتخدم مليارات مكالمات API. نظرًا للحمل الثقيل وللحفاظ على مستوى عالٍ من الخدمة ، فإن eBay لديها حدود لمكالمات API. تم تصميم حدود معدل API القياسي للأفراد والشركات الصغيرة.
يوفر الجدول التالي معدلات حد استدعاء واجهة برمجة التطبيقات الافتراضية للأفراد والشركات الصغيرة.
| فئة API | اسم API | حدود الاتصال الافتراضية |
| بيع واجهات برمجة التطبيقات | واجهة برمجة تطبيقات الجرد | 2 مليون مكالمة API يوميًا |
| واجهة برمجة تطبيقات ترويج التسويق | 10000 مكالمة API يوميًا | |
| واجهة برمجة تطبيقات الإعلانات التسويقية | 10000 مكالمة API يوميًا | |
| API اللوجستية | 2.5 مليون مكالمة API يوميًا | |
| قائمة API | 5000 مكالمة API يوميًا | |
| تغذية API | 100000 مكالمة API يوميًا | |
| شراء واجهات برمجة التطبيقات | تغذية | 10000 مكالمة API يوميًا |
| تسويق | 5000 مكالمة API يوميًا | |
| ترتيب | 5000 مكالمة API يوميًا | |
| واجهات برمجة تطبيقات التجارة | فهرس | 10000 مكالمة API يوميًا |
| التصنيف | 5000 مكالمة API يوميًا | |
| واجهات برمجة تطبيقات التسوق / الشراء التقليدية | واجهة برمجة تطبيقات التسوق | 5000 مكالمة API يوميًا |
| واجهات برمجة التطبيقات للبيع التقليدية | واجهة برمجة تطبيقات التداول | 5000 مكالمة API يوميًا |
| واجهة برمجة تطبيقات المنتج | 5000 مكالمة API يوميًا |
توثيق
يحتوي موقع مطور eBay على مجموعة واسعة من واجهات برمجة التطبيقات المتاحة وقسم توثيق API الخاص بهم معقد ومفصل إلى حد ما. هناك أيضًا بوابة أخبار للمطورين حيث يتم طرح أخبار ومقالات حول أحدث تغييرات API. كما يحتوي على قاعدة بيانات معرفية لتسهيل التنقل في البوابة والبحث عن المعلومات.