הפעילו הפצה מתוך המוצר שלכם
Engine הוא ה-API של Aevora. צרו שחרורים, מסרו אותם לפלטפורמות, קראו אנליטיקס והפעילו תמלוגים דרך 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}מה יש סביב נקודות הקצה
הקריאות הן החלק הקצר באינטגרציה. אלה החלקים ששומרים עליה פעילה כשאף אחד לא מסתכל.
- Webhooks
- קבלו אירוע כשמסירה משנה מצב, שחרור עולה לאוויר או דוח מוכן, כך שאין צורך בשאילתות חוזרות.
- מפתחות idempotency
- שלחו מפתח עם בקשת כתיבה, וניסיון חוזר יחזיר את התוצאה הראשונה במקום ליצור שחרור שני.
- עימוד
- רשימות מחזירות סמן. העבירו אותו חזרה כדי לקבל את העמוד הבא, באותו סדר בכל פעם.
- Sandbox
- סביבה נפרדת עם מפתחות משלה. מסירות רצות מתחילתן ועד סופן ונעצרות לפני כל פלטפורמה.
- גרסאות
- הגרסה היא חלק מהנתיב. שינוי שובר תאימות יוצא בגרסה חדשה, כך שהגרסה שעליה בניתם נשארת כפי שהיא.
- מגבלות קצב
- כל תגובה מציגה כמה מהמכסה שלכם נותר, ובקשה שהוגבלה מציינת מתי לנסות שוב.
ממפתח ראשון ועד מסירה חיה
- 1
קבלו את המפתחות
הגישו בקשה לחשבון. לאחר שהוא מאושר, צרו מפתח sandbox.
- 2
פתחו מול ה-sandbox
צרו שחרורים והריצו מסירות בדיקה עד שהאינטגרציה מטפלת בכל מצב.
- 3
בקשו גישה לייצור
ספרו לנו מה אתם בונים. אנחנו בודקים ומנפיקים מפתחות ייצור.
- 4
מסרו
עברו למפתח הייצור, ואותן קריאות מגיעות לפלטפורמות אמיתיות.
שאלות על Engine
לא. המסמך ציבורי. צריך חשבון, שאנחנו פותחים באמצעות בקשה, רק כשרוצים מפתח.
כן. שחרור שנוצר דרך ה-API מופיע בלוח הבקרה, ושחרור שנוצר בלוח הבקרה ניתן לקריאה ולמסירה דרך ה-API.
המסירה עוברת באותם מצבים כמו מסירה אמיתית ושולחת אותם webhooks, אבל שום דבר לא נשלח לפלטפורמה.