Működtesse a terjesztést a saját termékéből

Az Engine a Aevora API-ja. Hozzon létre kiadványokat, kézbesítse őket az áruházakba, olvassa az analitikát és futtassa a jogdíjakat REST-en keresztül, abból a termékből, amelyet az ügyfelei már használnak. A dokumentáció nyilvános, és sandbox áll rendelkezésre a fejlesztéshez.

Interfész
REST és JSON
Hitelesítés
API-kulcsok, környezetenként egy készlet
Sandbox
Tesztkézbesítések, áruházak bevonása nélkül

Négy hívás visz egy kiadványt a piszkozattól az elszámolásig

Az API azt az utat követi, amelyet a kiadvány az irányítópultban bejár: létrehozza, kézbesíti, olvassa a beérkező számokat, majd az elszámolást. Válasszon egy hívást, és látni fogja, mit küld, és mi jön vissza.

  • A kérések és a válaszok JSON-ben vannak
  • A hiba megnevezi a hibás mezőt és az okát
  • Ugyanazok a hívások működnek a sandboxban és az éles környezetben

Engine API

Példakérések

POST/v1/releases

Kérés törzse

{  "title": "Night Drive",  "artist": "Mira Kaya",  "label": "Northfield Audio",  "release_date": "2027-03-12"}

Válasz

{  "id": "rel_8f2k1",  "status": "draft",  "upc": null}

Ami a végpontok körül van

A hívások az integráció rövid része. Ezek azok a részek, amelyek működésben tartják, amikor senki sem figyeli.

Webhookok
Kapjon eseményt, ha egy kézbesítés állapota változik, egy kiadvány élesedik vagy egy elszámolás elkészül, így nem kell folyamatosan lekérdeznie.
Idempotenciakulcsok
Küldjön kulcsot egy írási kéréssel, és az ismétlés az első eredményt adja vissza ahelyett, hogy második kiadványt hozna létre.
Lapozás
A listák kurzort adnak vissza. Küldje vissza, hogy megkapja a következő oldalt, mindig ugyanabban a sorrendben.
Sandbox
Külön környezet saját kulcsokkal. A kézbesítések elejétől a végéig lefutnak, és bármelyik áruház előtt megállnak.
Verziókezelés
A verzió az útvonal része. A visszafelé nem kompatibilis változás új verzió alatt jelenik meg, így az, amelyre Ön épített, változatlan marad.
Kérési korlátok
Minden válasz megmondja, mennyi maradt a keretéből, a korlátozott kérés pedig azt, mikor próbálkozzon újra.

Az első kulcstól az éles kézbesítésig

  1. 1

    Szerezze be a kulcsait

    Jelentkezzen fiókra. A jóváhagyás után hozzon létre egy sandbox-kulcsot.

  2. 2

    Fejlesszen a sandboxban

    Hozzon létre kiadványokat és futtasson tesztkézbesítéseket, amíg az integrációja minden állapotot kezel.

  3. 3

    Éles hozzáférés kérése

    Mondja el, mit épít. Átnézzük, és kiadjuk az éles kulcsokat.

  4. 4

    Kézbesítés

    Váltson az éles kulcsra, és ugyanezek a hívások valódi áruházakat érnek el.

Kérdések az Engine-ről

Nem. A referencia nyilvános. Fiókra, amelyet jelentkezés alapján nyitunk, csak akkor van szüksége, ha kulcsot szeretne.

Igen. Az API-n keresztül létrehozott kiadvány megjelenik az irányítópultban, az irányítópultban létrehozott pedig olvasható és kézbesíthető az API-n keresztül.

A kézbesítés ugyanazokon az állapotokon megy át, mint egy valódi, és ugyanazokat a webhookokat küldi, de semmi sem megy áruházba.

Küldje el az első kérését a sandboxban