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 permintaanPOST/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
Dapatkan kunci anda
Mohon akaun. Setelah diluluskan, cipta kunci sandbox.
- 2
Bina dalam sandbox
Cipta keluaran dan jalankan penghantaran ujian sehingga integrasi anda mengendalikan setiap keadaan.
- 3
Mohon akses pengeluaran
Beritahu kami apa yang anda bina. Kami menyemaknya dan mengeluarkan kunci pengeluaran.
- 4
Hantar
Tukar kepada kunci pengeluaran dan panggilan yang sama sampai ke kedai sebenar.