REST Genel Bakış
Genel bakış
Pazar Verileri REST API'si, üçüncü taraf Steam pazar yerlerinden ürün listelemelerine, satın alma emirlerine, fiyat geçmişine ve satış verilerine erişim sağlar. Ana Steam API'sinden ayrı bir hizmettir ve kendi host'unda çalışır.
Temel URL
Tüm REST endpoint'leri tek bir host üzerinden sunulur.
https://marketplaceapi.steamapis.com/v2/
Kimlik doğrulama
API anahtarınızı X-API-Key istek başlığı olarak ekleyin. HTTP başlıkları büyük/küçük harf duyarsızdır, bu yüzden x-api-key de çalışır.
X-API-Key: YourSecretAPIKey
Alternatif olarak, anahtarı apiKey sorgu parametresi olarak geçirebilirsiniz. Başlık tercih edilir.
https://marketplaceapi.steamapis.com/v2/marketplaces?apiKey=YourSecretAPIKey
Yanıt formatı
{ "success": true, "response": {...} } zarfıyla sarmaz. Yanıt gövdesini doğrudan ayrıştırın.Başarılı bir yanıt, endpoint'e bağlı olarak tek bir nesne veya bir nesne dizisidir. Örneğin, GET /v2/marketplaces doğrudan gövdenin en üst seviyesinde bir dizi döndürür.
Hatalar
Hatalar 2xx olmayan bir HTTP durumuyla ve bir error mesajı ile makine tarafından okunabilir bir code içeren JSON gövdesiyle döndürülür.
{
"error": "Marketplace not found",
"code": "NOT_FOUND"
}
Önbellek ve istek limitleri
Yanıtlar sunucu tarafında 10 saniye boyunca önbelleğe alınır. İstemci tarafında istek limiti yoktur — önbellek tekrarlı trafiği emer.
Mevcut endpoint'ler
- GET /v2/marketplaces — desteklenen pazar yerlerini listeler
- GET /v2/items — teklifler ve satın alma emirleriyle tek bir ürünü getirir
- GET /v2/items/search — ürünleri ada göre arar
- GET /v2/items/compare — bir ürünü pazar yerleri arasında karşılaştırır
- GET /v2/buy-orders — satın alma emirlerini listeler
- GET /v2/price-history — fiyat geçmişi zaman serisi
- GET /v2/sales — son satışlar