Hoida jakelu omasta tuotteestasi

Engine on Aevoran API. Luo julkaisuja, toimita ne palveluihin, lue analytiikkaa ja hoida rojaltit REST-rajapinnan kautta asiakkaidesi jo käyttämästä tuotteesta. Dokumentaatio on julkinen, ja käytössä on hiekkalaatikko, jota vasten voit rakentaa.

Rajapinta
REST ja JSON
Tunnistautuminen
API-avaimet, yksi sarja ympäristöä kohden
Hiekkalaatikko
Testitoimituksia ilman palveluja

Neljä kutsua vie julkaisun luonnoksesta tilitykseen

API seuraa polkua, jonka julkaisu kulkee hallintapaneelissa: luo se, toimita se, lue luvut niiden saapuessa ja lue sitten tilitys. Valitse kutsu nähdäksesi, mitä lähetät ja mitä saat takaisin.

  • Pyynnöt ja vastaukset ovat JSON-muotoisia
  • Virhe kertoo, mikä kenttä epäonnistui ja miksi
  • Samat kutsut toimivat hiekkalaatikossa ja tuotannossa

Engine API

Esimerkkipyynnöt

POST/v1/releases

Pyynnön runko

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

Vastaus

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

Mitä päätepisteiden ympärillä on

Kutsut ovat integraation lyhyt osa. Nämä ovat osat, jotka pitävät sen toiminnassa, kun kukaan ei seuraa.

Webhookit
Vastaanota tapahtuma, kun toimituksen tila muuttuu, julkaisu menee ulos tai tilitys on valmis, jolloin sinun ei tarvitse kyselyttää.
Idempotenssiavaimet
Lähetä avain kirjoituspyynnön mukana, niin uusintayritys palauttaa ensimmäisen tuloksen sen sijaan, että luotaisiin toinen julkaisu.
Sivutus
Listat palauttavat kursorin. Välitä se takaisin saadaksesi seuraavan sivun, aina samassa järjestyksessä.
Hiekkalaatikko
Erillinen ympäristö omilla avaimillaan. Toimitukset kulkevat alusta loppuun ja pysähtyvät ennen yhtäkään palvelua.
Versiointi
Versio on osa polkua. Yhteensopivuuden rikkova muutos julkaistaan uuden version alla, joten se, jota vasten rakensit, pysyy ennallaan.
Pyyntörajat
Jokainen vastaus kertoo, kuinka paljon kiintiöstäsi on jäljellä, ja rajoitettu pyyntö kertoo, milloin voit yrittää uudelleen.

Ensimmäisestä avaimesta live-toimitukseen

  1. 1

    Hae avaimesi

    Hae tiliä. Kun se on hyväksytty, luo hiekkalaatikkoavain.

  2. 2

    Rakenna hiekkalaatikkoa vasten

    Luo julkaisuja ja aja testitoimituksia, kunnes integraatiosi käsittelee jokaisen tilan.

  3. 3

    Pyydä tuotantokäyttöä

    Kerro, mitä rakennat. Tarkistamme sen ja myönnämme tuotantoavaimet.

  4. 4

    Toimita

    Vaihda tuotantoavaimeen, niin samat kutsut tavoittavat oikeat palvelut.

Kysymyksiä Enginestä

Ei. Viite on julkinen. Tarvitset tilin, jonka avaamme hakemuksesta, vasta kun haluat avaimen.

Kyllä. API:n kautta luotu julkaisu näkyy hallintapaneelissa, ja hallintapaneelissa luodun voi lukea ja toimittaa API:n kautta.

Toimitus käy läpi samat tilat kuin oikea toimitus ja lähettää samat webhookit, mutta mitään ei lähetetä palveluun.

Tee ensimmäinen pyyntösi hiekkalaatikossa