Başvurmadan önce API'nin tamamını okuyun

Engine referansı açıktır. Kaynaklar, alanlar ve hatalar örneklerle belgelenmiştir ve hiçbiri bir formun arkasında değildir. Bir çağrıyı denemek istediğinizde hesap için başvurun ve bir sandbox anahtarı oluşturun.

Okumak için
Hesap gerekmez
Format
Örnekli REST referansı
Sandbox anahtarları
Onaylı bir hesapla

Bir istekle başlayın

Bir API'yi okumanın en hızlı yolu onu çağırmaktır. Bu dört istek iyi bir ilk saat sağlar: anahtarınızın çalıştığını doğrulayın, mevcut olanları listeleyin, bir yayın oluşturun ve olaylara abone olun.

  • Her endpoint bir istek ve bir yanıtla gösterilir
  • Hatalar nedenleri ve çözümleriyle listelenir
  • Örnekler sandbox üzerinde olduğu gibi çalışır

İlk istekler

Örnek istekler

GET/v1/me

Yanıt

{  "id": "acc_5t1m9",  "name": "Northfield Audio",  "environment": "sandbox"}

Kaynaklara göre referans

Yayınlar
Yayınları bölgeleri ve tarihleriyle birlikte oluşturun, güncelleyin, gönderin ve kaldırın.
Parçalar ve dosyalar
Parça ekleyin, ses ve kapak görseli yükleyin; kredileri, kodları ve paylaşımları belirleyin.
Teslimatlar
Bir yayını mağazalara gönderin ve her hedefi sırada durumundan yayında ya da reddedildi durumuna kadar izleyin.
Analitik
Dinlenme ve indirme verilerini mağaza, bölge, yayın, parça ve güne göre okuyun.
Royalty
Ekstreleri listeleyin, satırlarını okuyun ve her hak sahibinin ne alacağını görün.
Webhook'lar
Bir endpoint kaydedin, alacağı olayları seçin ve nelerin gönderildiğini inceleyin.

Sandbox üzerinde hızlı başlangıç

  1. 1

    Sandbox anahtarı oluşturun

    Hesap için başvurun ve onaylandıktan sonra anahtarı hesabınızdan kopyalayın.

  2. 2

    İlk isteğinizi yapın

    Çalıştığını doğrulamak için Authorization başlığında anahtarla /v1/me çağrısını yapın.

  3. 3

    Test yayını oluşturun

    Başlığı ve sanatçısıyla bir yayın gönderin, ardından ona bir parça ekleyin.

  4. 4

    Bir teslimatı simüle edin

    Sandbox'ta teslim edin ve hiçbir mağaza devreye girmeden durumun ilerleyişini izleyin.

Tek bir başlık, hepsi bu

Kimlik doğrulama, bearer token olarak gönderilen bir API anahtarıdır. El sıkışma ve canlı tutulacak bir oturum yoktur. Şunu kopyalayın, kendi anahtarınızı yazın ve çalıştırın.

  • Sandbox ve canlı ortam ayrı anahtarlar kullanır
  • Bir anahtar istediğiniz zaman iptal edilebilir

Yayınlarınızı listeleyin

bash
curl https://api.aevorarecords.com/v1/releases \  -H "Authorization: Bearer YOUR_API_KEY"

Dokümantasyon hakkında sorular

Hayır. Başvuru kaynağı herkese açıktır. Hesaba yalnızca bir anahtar istediğinizde ihtiyaç duyarsınız.

Endpoint'ler ve yanıtlar aynıdır. Sandbox teslimatları hiçbir mağazaya ulaşmadan durur ve sandbox verileri canlı kataloğunuzdan ayrı tutulur.

Eklemeler değişiklik günlüğünde belirtilir. Geriye dönük uyumsuz bir değişiklik yolda yeni bir sürümle yayınlanır; böylece üzerine kurduğunuz sürüm olduğu gibi kalır.

Önce okuyun, sonra istek gönderin