ڈسٹری بیوشن اپنی ہی پروڈکٹ سے چلائیں

Engine، Aevora کی API ہے۔ جس پروڈکٹ کو آپ کے صارفین پہلے سے استعمال کرتے ہیں اسی سے REST کے ذریعے ریلیز بنائیں، اسٹورز تک ترسیل کریں، اینالیٹکس پڑھیں اور رائلٹی چلائیں۔ دستاویزات عوامی ہیں اور بنانے اور آزمانے کے لیے ایک sandbox موجود ہے۔

انٹرفیس
REST اور JSON
تصدیقِ شناخت
API کیز، ہر ماحول کے لیے ایک سیٹ
Sandbox
آزمائشی ترسیلات، اسٹورز کے بغیر

چار کالز ریلیز کو ڈرافٹ سے اسٹیٹمنٹ تک پہنچاتی ہیں

API اسی راستے پر چلتی ہے جو ریلیز ڈیش بورڈ میں طے کرتی ہے: اسے بنائیں، ترسیل کریں، اعداد آتے ہی پڑھیں، پھر اسٹیٹمنٹ پڑھیں۔ کوئی کال چنیں تاکہ دیکھ سکیں کہ آپ کیا بھیجتے ہیں اور کیا واپس آتا ہے۔

  • ریکوئسٹ اور رسپانس JSON میں ہیں
  • خرابی بتاتی ہے کہ کون سا فیلڈ ناکام ہوا اور کیوں
  • وہی کالز sandbox اور پروڈکشن دونوں میں کام کرتی ہیں

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}

اینڈ پوائنٹس کے ارد گرد کیا ہوتا ہے

انٹیگریشن میں کالز مختصر حصہ ہیں۔ یہ وہ حصے ہیں جو کسی کے نہ دیکھنے پر بھی اسے چلتا رکھتے ہیں۔

ویب ہکس
جب ترسیل کی حالت بدلے، کوئی ریلیز لائیو ہو یا اسٹیٹمنٹ تیار ہو تو ایونٹ وصول کریں، تاکہ آپ کو بار بار پوچھنا نہ پڑے۔
Idempotency keys
لکھنے والی ریکوئسٹ کے ساتھ ایک کلید بھیجیں اور دوبارہ کوشش پر دوسری ریلیز بننے کی بجائے پہلا نتیجہ ملتا ہے۔
صفحہ بندی
فہرستیں ایک کرسر لوٹاتی ہیں۔ اسے واپس بھیجیں تاکہ ہر بار اسی ترتیب میں اگلا صفحہ ملے۔
Sandbox
اپنی کیز کے ساتھ ایک الگ ماحول۔ ترسیلات شروع سے آخر تک چلتی ہیں اور کسی بھی اسٹور سے پہلے رک جاتی ہیں۔
ورژننگ
ورژن راستے کا حصہ ہے۔ ناموافق تبدیلی نئے ورژن کے تحت آتی ہے، اس لیے جس ورژن پر آپ نے بنایا وہ جیسا ہے ویسا ہی رہتا ہے۔
ریٹ کی حدیں
ہر رسپانس بتاتا ہے کہ آپ کے کوٹے کا کتنا حصہ باقی ہے، اور محدود کی گئی ریکوئسٹ بتاتی ہے کہ دوبارہ کب کوشش کریں۔

پہلی کلید سے لائیو ترسیل تک

  1. 1

    اپنی کیز حاصل کریں

    اکاؤنٹ کے لیے درخواست دیں۔ منظوری کے بعد sandbox کلید بنائیں۔

  2. 2

    sandbox پر بنائیں

    ریلیز بنائیں اور آزمائشی ترسیلات چلائیں جب تک آپ کی انٹیگریشن ہر حالت کو نہ سنبھال لے۔

  3. 3

    پروڈکشن تک رسائی کی درخواست کریں

    بتائیں کہ آپ کیا بنا رہے ہیں۔ ہم اس کا جائزہ لے کر پروڈکشن کیز جاری کرتے ہیں۔

  4. 4

    ترسیل کریں

    پروڈکشن کلید پر جائیں اور وہی کالز حقیقی اسٹورز تک پہنچتی ہیں۔

Engine کے بارے میں سوالات

نہیں۔ حوالہ عوامی ہے۔ آپ کو اکاؤنٹ، جو ہم درخواست پر کھولتے ہیں، صرف تب چاہیے جب آپ کو کلید درکار ہو۔

جی ہاں۔ API سے بنائی گئی ریلیز ڈیش بورڈ میں نظر آتی ہے، اور ڈیش بورڈ میں بنائی گئی ریلیز API سے پڑھی اور بھیجی جا سکتی ہے۔

ترسیل ان ہی حالتوں سے گزرتی ہے جن سے حقیقی ترسیل گزرتی ہے اور وہی ویب ہکس بھیجتی ہے، مگر کسی اسٹور کو کچھ نہیں بھیجا جاتا۔

sandbox میں اپنی پہلی ریکوئسٹ کریں