/v1/offers/accounts,
/v1/offers/currency vb. — ve kendi alanlarını taşır. Yalnızca satış yaptığın
kategorilerle entegre olursun; platforma sonradan eklenen bir kategori
seninkileri etkilemez.
Bu, herkese açık arayüzdür. Satıcı panelinin kendi ekranları — para çekme,
anlaşmazlıklar, hesap ayarları — buna dahil değildir ve bir API anahtarı bunlara
erişemez.
Bir ilan, pazar yerindeki tek bir listelemedir. API bunlara offers der,
aşağıdaki her şey de öyle.
Temel URL
/v1/....
İlk isteğin
1
Bir anahtar oluştur
Satıcı panelinde Satıcı → API anahtarları bölümüne git ve bir anahtar
oluştur. Yalnızca bir kez gösterilir — o anda kopyala, sonradan tekrar
okumanın yolu yok.
2
Anahtarı gönder
Anahtar her isteğin
Authorization başlığına eklenir. Başka bir şeyle
takas edilmesi gerekmez.3
Kategorinin alanlarını oku
Bir kategorinin oluşturma çağrısının ne aldığı, o kategorinin kendi referans
sayfasındadır — hesap ilanının fiyatı ve görselleri, oyun parası ilanının
ürünü ve stoğu vardır. Oyuna göre değişen kısım Bu yol bir oyunun
attributes alanıdır; şema
endpoint’i bunları döndürür: alanlar, türleri ve hangilerinin zorunlu olduğu.slug değerini çözer. Diğer katalog yolları oyunu
GET /v1/offers/games tarafından döndürülen id ile belirtir — orada slug
kullanmak 400 döndürür.Katalog okumaları herkese açıktır — anahtarın olmadan da keşfedebilirsin.Durumlar
Yeni bir ilandraft durumundadır: senindir ve başkası göremez. publish onu
active yapar ve alıcılar o andan itibaren satın alabilir — önceden kimse
incelemez. Satacak bir şeyi kalmamış bir ilanı yayınlamak 409 ile reddedilir:
önce stok ekle. Düzenlemek ilanın durumunu değiştirmez — active bir ilan
yayında kalır, draft taslak olarak kalır.
unpublish, active bir ilanı draft durumuna geri alır. archived yolun
sonudur: DELETE bir ilanı kalıcı olarak kaldırır ve senin için okunabilir
bırakır. sold çağrılardan değil siparişlerden gelir: son birim kapanmış bir
siparişe gitmiştir. Tüm stoğu açık siparişlerde olan bir ilan active kalır;
iptal edilen bir sipariş stoğu geri koyar.
Moderasyon yayındaki bir ilanı changes_requested olarak geri gönderebilir:
ilan pazar yerinden çıkar; moderation_reason_code ve moderation_note neyin
düzeltileceğini söyler. Bir sonraki PATCH isteğin onu draft yapar;
düzelttikten sonra publish ile yayınla. Moderasyonun kuralları açıkça ihlal
ettiği için kaldırdığı ilan silinir: onunla ilgili her çağrı 404 döndürür.
Fiyatlar
Bu API’deki her fiyat, ABD senti cinsinden bir tam sayıdır.price: 4990,
49,90 $ demektir. Kesirli tutar yoktur ve tek para birimi USD’dir.
Sonraki adımlar
Kimlik doğrulama
Anahtarlar, adres izin listeleri, istek sınırları ve hataların anlamı.
API referansı
Her endpoint, gerçek istek gönderebileceğin bir test alanıyla birlikte.