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 isteklerGET/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
Sandbox anahtarı oluşturun
Hesap için başvurun ve onaylandıktan sonra anahtarı hesabınızdan kopyalayın.
- 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
Test yayını oluşturun
Başlığı ve sanatçısıyla bir yayın gönderin, ardından ona bir parça ekleyin.
- 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
bashcurl https://api.aevorarecords.com/v1/releases \ -H "Authorization: Bearer YOUR_API_KEY"