Provozujte distribuci z vlastního produktu
Engine je API Aevora. Vytvářejte vydání, doručujte je do obchodů, čtěte analytiku a spouštějte royalties přes REST, z produktu, který vaši zákazníci už používají. Dokumentace je veřejná a k dispozici je sandbox, ve kterém můžete stavět.
- Rozhraní
- REST a JSON
- Autentizace
- Klíče API, jedna sada pro každé prostředí
- Sandbox
- Testovací doručení bez zapojení obchodů
Čtyři volání dovedou vydání od konceptu k vyúčtování
API sleduje cestu, kterou vydání prochází v dashboardu: vytvoříte ho, doručíte, průběžně čtete čísla a nakonec vyúčtování. Vyberte volání a uvidíte, co posíláte a co se vrací.
- Požadavky i odpovědi jsou JSON
- Chyba uvádí pole, které selhalo, a proč
- Stejná volání fungují v sandboxu i v produkci
Engine API
Ukázkové požadavkyPOST/v1/releases
Tělo požadavku
{ "title": "Night Drive", "artist": "Mira Kaya", "label": "Northfield Audio", "release_date": "2027-03-12"}Odpověď
{ "id": "rel_8f2k1", "status": "draft", "upc": null}Co je okolo endpointů
Samotná volání jsou na integraci to krátké. Tohle je to, co ji udrží v chodu, když se nikdo nedívá.
- Webhooky
- Dostanete událost, když se změní stav doručení, vydání se zveřejní nebo je připraveno vyúčtování, takže se nemusíte opakovaně dotazovat.
- Klíče idempotence
- Pošlete klíč spolu se zápisovým požadavkem a opakování vrátí první výsledek místo vytvoření druhého vydání.
- Stránkování
- Seznamy vracejí kurzor. Pošlete ho zpět a dostanete další stránku, pokaždé ve stejném pořadí.
- Sandbox
- Samostatné prostředí s vlastními klíči. Doručení proběhnou od začátku do konce a zastaví se před jakýmkoli obchodem.
- Verzování
- Verze je součástí cesty. Zásadní změna vychází pod novou verzí, takže ta, pro kterou jste stavěli, zůstane beze změny.
- Limity frekvence
- Každá odpověď říká, kolik z vašeho limitu zbývá, a omezený požadavek říká, kdy to zkusit znovu.
Od prvního klíče k ostrému doručení
- 1
Získejte klíče
Požádejte o účet. Po schválení vytvořte klíč sandboxu.
- 2
Stavte v sandboxu
Vytvářejte vydání a spouštějte testovací doručení, dokud vaše integrace nezvládne každý stav.
- 3
Požádejte o produkční přístup
Napište nám, co stavíte. Posoudíme to a vydáme produkční klíče.
- 4
Doručujte
Přepněte na produkční klíč a stejná volání zasáhnou skutečné obchody.