Geliştirici API'si
SkinCash üzerindeki CS2 (CS:GO) skinleri için ücretsiz, herkese açık bir fiyat akışı. Fiyat karşılaştırma siteleri, toplayıcılar ve tarayıcı eklentileri için tasarlandı. API anahtarı yok, kayıt yok — sadece basit bir GET isteği.
# örnek yanıt — canlı API'yi denemek için Çalıştır'a basın
{
"currency": "USD",
"updated_at": "2026-08-05T12:00:00.000Z",
"count": 25812,
"items": [
{
"market_hash_name": "AK-47 | Redline (Field-Tested)",
"price": 14.50,
"quantity": 12,
"item_page": "https://skincash.gg/en/market/item/ak-47-redline-field-tested"
}
], …
}Bir bakışta
Hızlı başlangıç
Tüm canlı kataloğu tek bir istekte çekin. Accept-Encoding: gzip (curl'ün --compressed seçeneği) gönderin — tam akış sıkıştırılmamış halde birkaç MB'tır.
curl -s --compressed https://api.skincash.gg/v1/pricesDil seçiminiz sayfanın tamamında geçerli kalır.
Kimlik doğrulama
API herkese açıktır — her uç nokta düz bir GET'tir, kayıt yok, OAuth yok. CORS açıktır, bu yüzden doğrudan bir tarayıcıdan çağırabilirsiniz. Sadece isteği gönderin:
Anonim erişim IP başına hız sınırlıdır (bkz. Hız limitleri). Bir toplayıcı veya eklenti çalıştırıyor ve daha fazlasına ihtiyaç duyuyorsanız, limitinizi yükselten ücretsiz bir ortak anahtar veriyoruz — başka hiçbir davranış değişmez. Bunu bir Authorization: Bearer başlığı (veya X-API-Key) olarak gönderin:
curl -s --compressed \
-H "Authorization: Bearer YOUR_API_KEY" \
https://api.skincash.gg/v1/prices[email protected] adresinden anahtar talep edin. Sunucu tarafında saklayın; bir parola gibi davranın.
Uç noktalar
Tam katalog — satıştaki her ürün, en düşük alış fiyatı + canlı stok + derin bağlantı, en pahalıdan başlayarak sıralanır. gzip ve koşullu istekleri destekler. Canlı deneyin ↑
curl -s --compressed https://api.skincash.gg/v1/prices{
"currency": "USD",
"updated_at": "2026-08-05T12:00:00.000Z",
"count": 25812,
"items": [
{
"market_hash_name": "AK-47 | Redline (Field-Tested)",
"price": 14.50,
"quantity": 12,
"item_page": "https://skincash.gg/en/market/item/ak-47-redline-field-tested"
}
]
}Tam Steam adına göre tek bir ürün (URL kodlanmış). Şu anda satışta değilse 404 döndürür.
market_hash_namedize · zorunluTam Steam market_hash_name, URL kodlanmış.curl -s --compressed \
"https://api.skincash.gg/v1/prices/AK-47%20%7C%20Redline%20(Field-Tested)"{
"currency": "USD",
"updated_at": "2026-08-05T12:00:00.000Z",
"market_hash_name": "AK-47 | Redline (Field-Tested)",
"price": 14.50,
"quantity": 12,
"item_page": "https://skincash.gg/en/market/item/ak-47-redline-field-tested"
}Ürün meta verisi — satıştaki her ürün için görsel, tür, nadirlik (fiyat yok). Kazımaya gerek kalmadan SkinCash listelemelerini oluşturup birleştirmenizi sağlar. /prices ile aynı 5 dakikalık önbellek + koşullu GET.
curl -s --compressed https://api.skincash.gg/v1/catalog{
"updated_at": "2026-08-05T12:00:00.000Z",
"count": 25812,
"items": [
{
"market_hash_name": "AK-47 | Redline (Field-Tested)",
"image": "https://cdn.skincash.gg/sc/economy/image/class/730/…",
"type": "Rifle",
"rarity": "Classified"
}
]
}(Kısmi) ada göre ürün arayın → alış fiyatı + kanonik derin bağlantı. Fiyat karşılaştırma araçları ve tarayıcı eklentileri için karşılaştır-ve-tıkla yüzeyi. Tam/önek eşleşmeleri önce sıralanır.
qdize · zorunlu2–200 karakter, büyük/küçük harf duyarsız.limittam sayı · isteğe bağlı1–100, varsayılan 50.curl -s "https://api.skincash.gg/v1/search?q=redline&limit=5"{
"currency": "USD",
"updated_at": "2026-08-05T12:00:00.000Z",
"query": "redline",
"count": 1,
"items": [
{
"market_hash_name": "AK-47 | Redline (Field-Tested)",
"price": 14.50,
"quantity": 12,
"item_page": "https://skincash.gg/en/market/item/ak-47-redline-field-tested"
}
]
}Tüm API için makine tarafından okunabilir OpenAPI 3.1 spesifikasyonu — kod üreticiler, API istemcileri ve LLM'ler için ilk durak.
curl -s https://api.skincash.gg/v1/openapi.jsonYanıt şeması
Akış düzeyindeki updated_at, her satırın tazeliğidir: tüm fiyatlar her döngüde (~5 dk) birlikte yenilenir. Fiyatlar, bir müşterinin ödediği alış fiyatıdır.
Verimli yoklama (ETag / 304)
Her yanıt bir ETag ve Last-Modified taşır. Bir sonraki yoklamanızda bunları geri gönderin; hiçbir şey değişmediğinde ucuz bir 304 Not Modified (gövdesiz) alın — kataloğu yeniden indirmeden istediğiniz sıklıkta yoklayın.
# Save the ETag from the first response, then:
curl -s -o /dev/null -w "%{http_code}\n" \
-H 'If-None-Match: "your-saved-etag"' \
https://api.skincash.gg/v1/prices
# -> 304 when unchanged, 200 (with body) when refreshedHız limitleri
Tam dökümler — /prices, /catalog
Hafif okumalar — /prices/{name}, /search
Limitler IP başınadır ve yük ağırlığına göre bölünür. Akış önbelleklenir, bu yüzden koşullu isteklerle 5 dakikalık bir yoklama limite hiç yaklaşmaz. Bir limiti aşmak, Retry-After başlığıyla birlikte 429 RATE_LIMITED döndürür. Yüksek trafikli bir entegrasyon için daha yüksek limitlere mi ihtiyacınız var? Bir ortak anahtar hakkında bize sorun.
Sürümleme ve kararlılık
API, yolda sürümlenir (/v1). Bir sürüm içinde yalnızca alan ekleriz — mevcut bir alan asla yeniden adlandırılmaz, kaldırılmaz veya türü değiştirilmez, bu yüzden ayrıştırıcınız bozulmaz. Bozan değişiklikler, önceden bildirimle yeni bir sürüm olarak gönderilir.
Hatalar
Hatalar her zaman tutarlı tek bir gövde şeklini paylaşır:
{
"success": false,
"error": {
"error_code": "NOT_FOUND",
"message": "No live price for this item."
}
}Bir toplayıcı veya eklenti mi çalıştırıyorsunuz?
SkinCash'i bir kaynak olarak listeleyin — yukarıdaki akış bugün tüketime hazır. Alım spesifikasyonunuza uyum sağlamaktan, alan eklemekten veya bir ortaklık düzenlemesi kurmaktan memnuniyet duyarız. Bize ulaşın, hızlıca hareket edelim.
[email protected]