הפעילו הפצה מתוך המוצר שלכם

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. 1

    קבלו את המפתחות

    הגישו בקשה לחשבון. לאחר שהוא מאושר, צרו מפתח sandbox.

  2. 2

    פתחו מול ה-sandbox

    צרו שחרורים והריצו מסירות בדיקה עד שהאינטגרציה מטפלת בכל מצב.

  3. 3

    בקשו גישה לייצור

    ספרו לנו מה אתם בונים. אנחנו בודקים ומנפיקים מפתחות ייצור.

  4. 4

    מסרו

    עברו למפתח הייצור, ואותן קריאות מגיעות לפלטפורמות אמיתיות.

שאלות על Engine

לא. המסמך ציבורי. צריך חשבון, שאנחנו פותחים באמצעות בקשה, רק כשרוצים מפתח.

כן. שחרור שנוצר דרך ה-API מופיע בלוח הבקרה, ושחרור שנוצר בלוח הבקרה ניתן לקריאה ולמסירה דרך ה-API.

המסירה עוברת באותם מצבים כמו מסירה אמיתית ושולחת אותם webhooks, אבל שום דבר לא נשלח לפלטפורמה.

בצעו את הבקשה הראשונה ב-sandbox