شغّل التوزيع من منتجك الخاص
Engine هو واجهة Aevora البرمجية. أنشئ الإصدارات وسلّمها إلى المتاجر واقرأ التحليلات وشغّل العائدات عبر REST، من المنتج الذي يستخدمه عملاؤك بالفعل. الوثائق عامة وتتوفر بيئة تجريبية للبناء عليها.
- الواجهة
- REST وJSON
- المصادقة
- مفاتيح API، مجموعة لكل بيئة
- البيئة التجريبية
- تسليمات تجريبية دون إشراك أي متجر
أربعة استدعاءات تنقل الإصدار من المسودة إلى الكشف
تتبع الواجهة البرمجية المسار الذي يسلكه الإصدار في لوحة التحكم: أنشئه، سلّمه، اقرأ الأرقام فور وصولها، ثم اقرأ الكشف. اختر استدعاءً لترى ما ترسله وما يعود إليك.
- الطلبات والاستجابات بصيغة JSON
- يحدّد الخطأ الحقل الذي فشل وسبب فشله
- تعمل الاستدعاءات نفسها في البيئة التجريبية وفي الإنتاج
Engine API
أمثلة على الطلباتPOST/v1/releases
نص الطلب
{ "title": "Night Drive", "artist": "Mira Kaya", "label": "Northfield Audio", "release_date": "2027-03-12"}الاستجابة
{ "id": "rel_8f2k1", "status": "draft", "upc": null}ما يحيط بنقاط النهاية
الاستدعاءات هي الجزء القصير من أي تكامل. وهذه هي الأجزاء التي تبقيه يعمل حين لا يراقبه أحد.
- Webhooks
- استقبل حدثًا حين تتغير حالة تسليم أو يصدر إصدار أو يصبح كشف جاهزًا، فلا تحتاج إلى الاستعلام المتكرر.
- مفاتيح عدم التكرار
- أرسل مفتاحًا مع طلب كتابة، فتعيد إعادة المحاولة النتيجة الأولى بدلًا من إنشاء إصدار ثانٍ.
- التصفح بالصفحات
- تعيد القوائم مؤشرًا. مرّره مجددًا للحصول على الصفحة التالية، بالترتيب نفسه في كل مرة.
- البيئة التجريبية
- بيئة منفصلة بمفاتيحها الخاصة. تعمل عمليات التسليم من البداية إلى النهاية وتتوقف قبل أي متجر.
- الإصدارات
- يُدرج الإصدار في المسار. يُطرح أي تغيير جذري تحت إصدار جديد، فيبقى الإصدار الذي بنيت عليه كما هو.
- حدود المعدل
- تخبرك كل استجابة بما تبقى من حصتك، ويخبرك الطلب المحدود بموعد إعادة المحاولة.
من أول مفتاح إلى التسليم الفعلي
- 1
احصل على مفاتيحك
قدّم طلبًا لفتح حساب. بعد الموافقة عليه، أنشئ مفتاح البيئة التجريبية.
- 2
ابنِ على البيئة التجريبية
أنشئ إصدارات وشغّل تسليمات تجريبية حتى يتعامل تكاملك مع كل حالة.
- 3
اطلب الوصول إلى الإنتاج
أخبرنا بما تبنيه. نراجعه ونصدر لك مفاتيح الإنتاج.
- 4
سلّم
بدّل إلى مفتاح الإنتاج لتصل الاستدعاءات نفسها إلى المتاجر الحقيقية.
أسئلة حول Engine
لا. المرجع متاح للجميع. لا تحتاج إلى حساب، نفتحه عبر تقديم طلب، إلا عندما تريد مفتاحًا.
نعم. يظهر الإصدار المُنشأ عبر الواجهة البرمجية في لوحة التحكم، ويمكن قراءة الإصدار المُنشأ في لوحة التحكم وتسليمه عبر الواجهة البرمجية.
يمر التسليم بالحالات نفسها التي يمر بها التسليم الحقيقي ويُرسل webhooks نفسها، لكن لا يُرسل شيء إلى أي متجر.