Jalankan distribusi dari produk Anda sendiri

Engine adalah API Aevora. Buat rilis, kirim ke toko, baca analitik, dan jalankan royalti lewat REST, dari produk yang sudah digunakan pelanggan Anda. Dokumentasinya publik dan tersedia sandbox untuk membangun integrasi.

Antarmuka
REST dan JSON
Autentikasi
Kunci API, satu set untuk tiap lingkungan
Sandbox
Uji pengiriman, tanpa melibatkan toko

Empat panggilan membawa rilis dari draf hingga laporan

API mengikuti jalur yang dilalui rilis di dasbor: buat, kirim, baca angkanya saat masuk, lalu baca laporannya. Pilih sebuah panggilan untuk melihat apa yang Anda kirim dan apa yang dikembalikan.

  • Permintaan dan respons berformat JSON
  • Kesalahan menyebutkan kolom yang gagal dan alasannya
  • Panggilan yang sama berlaku di sandbox dan di produksi

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}

Yang ada di sekitar endpoint

Panggilan API adalah bagian terpendek dari sebuah integrasi. Berikut bagian-bagian yang menjaganya tetap berjalan saat tidak ada yang mengawasi.

Webhook
Terima event saat status pengiriman berubah, rilis tayang, atau laporan siap, sehingga Anda tidak perlu polling.
Kunci idempotensi
Kirim kunci bersama permintaan tulis, dan percobaan ulang mengembalikan hasil pertama alih-alih membuat rilis kedua.
Paginasi
Daftar mengembalikan kursor. Kirim kembali kursor itu untuk mendapatkan halaman berikutnya, selalu dalam urutan yang sama.
Sandbox
Lingkungan terpisah dengan kunci tersendiri. Pengiriman berjalan dari awal sampai akhir dan berhenti sebelum sampai ke toko mana pun.
Versi
Versi menjadi bagian dari path. Perubahan yang merusak dirilis dengan versi baru, sehingga versi yang Anda gunakan tetap seperti semula.
Batas laju
Setiap respons memberi tahu berapa sisa jatah Anda, dan permintaan yang dibatasi memberi tahu kapan harus mencoba lagi.

Dari kunci pertama hingga pengiriman langsung

  1. 1

    Dapatkan kunci Anda

    Ajukan akun. Setelah disetujui, buat kunci sandbox.

  2. 2

    Bangun di sandbox

    Buat rilis dan jalankan pengiriman uji hingga integrasi Anda menangani setiap status.

  3. 3

    Minta akses produksi

    Ceritakan apa yang sedang Anda bangun. Kami meninjaunya dan menerbitkan kunci produksi.

  4. 4

    Kirim

    Beralih ke kunci produksi dan panggilan yang sama akan menjangkau toko sungguhan.

Pertanyaan seputar Engine

Tidak. Referensinya publik. Anda baru memerlukan akun, yang kami buka melalui pengajuan, saat menginginkan kunci.

Bisa. Rilis yang dibuat lewat API muncul di dasbor, dan rilis yang dibuat di dasbor dapat dibaca dan dikirim lewat API.

Pengiriman melewati status yang sama seperti pengiriman sungguhan dan mengirim webhook yang sama, tetapi tidak ada yang dikirim ke toko.

Buat permintaan pertama Anda di sandbox