Dağıtımı kendi ürününüzden yönetin

Engine, Aevora API'sidir. Müşterilerinizin zaten kullandığı ürünün içinden REST üzerinden yayın oluşturun, mağazalara teslim edin, analitik verilerini okuyun ve royalty hesaplamalarını yürütün. Dokümantasyon herkese açık, üzerinde geliştirme yapabileceğiniz bir sandbox da var.

Arayüz
REST ve JSON
Kimlik doğrulama
API anahtarları, her ortam için ayrı set
Sandbox
Test teslimatları, mağaza devreye girmeden

Dört çağrıyla taslaktan ekstreye

API, bir yayının panelde izlediği yolu izler: oluşturun, teslim edin, rakamlar geldikçe okuyun, ardından ekstreyi okuyun. Bir çağrı seçin; ne gönderdiğinizi ve ne geri geldiğini görün.

  • İstekler ve yanıtlar JSON formatındadır
  • Hata mesajı, hangi alanın neden başarısız olduğunu söyler
  • Aynı çağrılar hem sandbox'ta hem canlı ortamda çalışır

Engine API

Örnek istekler

POST/v1/releases

İstek gövdesi

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

Yanıt

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

Endpoint'lerin etrafındaki yapı

Çağrılar bir entegrasyonun kısa kısmıdır. Kimse izlemiyorken entegrasyonu ayakta tutan asıl parçalar ise bunlardır.

Webhook'lar
Bir teslimatın durumu değiştiğinde, bir yayın yayına girdiğinde veya bir ekstre hazır olduğunda olay alın; sürekli sorgulamanız gerekmez.
Idempotency anahtarları
Yazma isteğiyle birlikte bir anahtar gönderin; yeniden denemede ikinci bir yayın oluşmaz, ilk sonuç döner.
Sayfalama
Listeler bir imleç (cursor) döndürür. Sonraki sayfayı almak için imleci geri gönderin; sıralama her seferinde aynı kalır.
Sandbox
Kendi anahtarlarına sahip ayrı bir ortam. Teslimatlar baştan sona çalışır ve hiçbir mağazaya ulaşmadan durur.
Sürümleme
Sürüm, yolun bir parçasıdır. Geriye dönük uyumsuz bir değişiklik yeni bir sürümle yayımlanır; böylece üzerine geliştirme yaptığınız sürüm olduğu gibi kalır.
Hız sınırları
Her yanıt, kullanım hakkınızın ne kadarının kaldığını söyler; limite takılan bir istek de ne zaman yeniden deneyeceğinizi bildirir.

İlk anahtardan canlı teslimata

  1. 1

    Anahtarlarınızı alın

    Hesap için başvurun. Onaylandıktan sonra bir sandbox anahtarı oluşturun.

  2. 2

    Sandbox üzerinde geliştirin

    Entegrasyonunuz her durumu karşılayana kadar yayın oluşturun ve test teslimatları çalıştırın.

  3. 3

    Canlı ortam erişimi isteyin

    Ne geliştirdiğinizi bize anlatın. İnceleyip canlı ortam anahtarlarını veriyoruz.

  4. 4

    Teslim edin

    Canlı ortam anahtarına geçin; aynı çağrılar artık gerçek mağazalara ulaşır.

Engine hakkında sorular

Hayır. Referans herkese açıktır. Başvuruyla açtığımız hesaba yalnızca bir anahtar istediğinizde ihtiyacınız olur.

Evet. API üzerinden oluşturulan bir yayın panelde görünür; panelde oluşturulan bir yayın da API üzerinden okunabilir ve teslim edilebilir.

Teslimat, gerçek bir teslimatla aynı durumlardan geçer ve aynı webhook'ları gönderir; ancak hiçbir mağazaya bir şey gönderilmez.

Sandbox'ta ilk isteğinizi yapın