Jalankan pengedaran daripada produk anda sendiri

Engine ialah API Aevora. Cipta keluaran, hantar ke kedai, baca analitik dan jalankan royalti melalui REST, daripada produk yang sudah digunakan pelanggan anda. Dokumen terbuka untuk umum dan ada sandbox untuk anda bina.

Antara muka
REST dan JSON
Pengesahan
Kunci API, satu set bagi setiap persekitaran
Sandbox
Penghantaran ujian, tanpa melibatkan kedai

Empat panggilan membawa keluaran daripada draf hingga penyata

API mengikut laluan yang dilalui keluaran dalam papan pemuka: cipta, hantar, baca angka apabila tiba, kemudian baca penyata. Pilih satu panggilan untuk melihat apa yang anda hantar dan apa yang dikembalikan.

  • Permintaan dan respons ialah JSON
  • Ralat menyebut medan yang gagal dan sebabnya
  • Panggilan yang sama berfungsi dalam sandbox dan dalam pengeluaran

API Engine

Contoh permintaan

POST/v1/releases

Isi permintaan

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

Respons

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

Apa yang ada di sekeliling endpoint

Panggilan ialah bahagian yang pendek dalam sesuatu integrasi. Inilah bahagian yang memastikannya berfungsi apabila tiada sesiapa memerhati.

Webhook
Terima peristiwa apabila penghantaran bertukar keadaan, keluaran menjadi aktif atau penyata sedia, supaya anda tidak perlu membuat tinjauan berulang.
Kunci idempotensi
Hantar kunci bersama permintaan tulis dan percubaan semula mengembalikan hasil pertama dan bukannya mencipta keluaran kedua.
Penomboran halaman
Senarai mengembalikan kursor. Hantar semula untuk mendapat halaman seterusnya, dalam susunan yang sama setiap kali.
Sandbox
Persekitaran berasingan dengan kunci sendiri. Penghantaran berjalan dari awal hingga akhir dan berhenti sebelum sampai ke mana-mana kedai.
Pemversian
Versi merupakan sebahagian daripada laluan. Perubahan yang memecahkan keserasian dikeluarkan di bawah versi baharu, jadi versi yang anda bina kekal seperti asal.
Had kadar
Setiap respons memberitahu anda berapa banyak kuota yang tinggal, dan permintaan yang dihadkan memberitahu bila untuk mencuba semula.

Daripada kunci pertama hingga penghantaran langsung

  1. 1

    Dapatkan kunci anda

    Mohon akaun. Setelah diluluskan, cipta kunci sandbox.

  2. 2

    Bina dalam sandbox

    Cipta keluaran dan jalankan penghantaran ujian sehingga integrasi anda mengendalikan setiap keadaan.

  3. 3

    Mohon akses pengeluaran

    Beritahu kami apa yang anda bina. Kami menyemaknya dan mengeluarkan kunci pengeluaran.

  4. 4

    Hantar

    Tukar kepada kunci pengeluaran dan panggilan yang sama sampai ke kedai sebenar.

Soalan tentang Engine

Tidak. Rujukan ini awam. Anda hanya memerlukan akaun, yang kami buka melalui permohonan, apabila anda mahu kunci.

Boleh. Keluaran yang dicipta melalui API muncul dalam papan pemuka, dan yang dicipta dalam papan pemuka boleh dibaca dan dihantar melalui API.

Penghantaran melalui keadaan yang sama seperti yang sebenar dan menghantar webhook yang sama, tetapi tiada apa-apa dihantar ke kedai.

Buat permintaan pertama anda dalam sandbox