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žadavky

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

    Získejte klíče

    Požádejte o účet. Po schválení vytvořte klíč sandboxu.

  2. 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. 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. 4

    Doručujte

    Přepněte na produkční klíč a stejná volání zasáhnou skutečné obchody.

Otázky k Engine

Ne. Dokumentace je veřejná. Účet, který otevíráme na základě žádosti, potřebujete, až když chcete klíč.

Ano. Vydání vytvořené přes API se objeví v dashboardu a vydání vytvořené v dashboardu lze číst a doručovat přes API.

Doručení projde stejnými stavy jako skutečné a odešle stejné webhooky, ale do obchodu se nic neposílá.

Pošlete první požadavek v sandboxu