Dasturchilar uchun ochiq API
CS2, Dota 2, Rust va TF2 narxlari, CS2 tahlili va bozor indeksi, oʻyinlar boʻyicha mavjud jami qiymatli Steam inventar baholari, CS2 jamoa va oʻyinchilari uchun bepul, faqat oʻqiladigan JSON API. Koʻp manzillarga bepul shaxsiy API kaliti kerak; u cheklovlarni ham oshiradi. Bozor indeksi va float qidiruvi kalitsiz ishlaydi. Qoʻllanadigan parametr va maʼlumotlar quyida.
Brauzer kengaytmasi
CS2 buyumlarini saqlang, narx oʻzgarishlarini kuzating va Steam’ning oʻzida bozor takliflarini solishtiring.
API’ga kirish va shaxsiy cheklovlar
Kalitsiz
Bozor indeksi va float qidiruvlari hisobga kirmasdan ishlaydi: har IP manzil uchun daqiqasiga 5 ta soʻrov. Narxlar, takliflar, maʼlumot holati, drop havzasi, jamoalar, oʻyinchilar va inventarlar uchun kalit kerak.
API manzillariKalit bilan
Skript va integratsiyalaringiz uchun bepul shaxsiy kalit. Narxlar, takliflar, maʼlumot holati, drop havzasi, jamoalar, oʻyinchilar va inventarlarni ochadi hamda har kalit uchun alohida hisoblanadigan cheklovlarni oshiradi.
Kalitni qanday olish mumkin| Cheklov | Kalitsiz | Kalit bilan |
|---|---|---|
| Daqiqalik soʻrovlar | 5 | 120 |
| Soatlik inventar soʻrovlari: bitta va jamlangan | Kalit kerak | 480 |
| Daqiqalik ilk inventar qidiruvlari | Kalit kerak | 48 |
| /api/ | Kalit kerak | 100 |
| /api/ | 10 | 15 |
Soatlik inventar kvotasi ikkala manzilni ham qamraydi; jamlangan chaqiruv bitta soʻrov hisoblanadi. stale: true bilan qaytgan bitta inventar bu kvotani sarflamaydi. Ilk qidiruvlar — hali saqlangan bahosi yoʻq profillar soʻrovi.
Bitta IP manzildan ishlatilgan barcha kalitlar qaysi hisobga tegishliligidan qatʼi nazar umumiy chegaraga ega: daqiqasiga 240 ta soʻrov, soatiga 960 ta inventar soʻrovi, daqiqasiga 96 ta ilk qidiruv va 30 ta oʻyin koordinatori qidiruvi.
Kalitni qanday olish mumkin
- Steam orqali kirib, profilingizdagi API kalitlari boʻlimini oching. Profilga oʻtish
- Skinory’da roʻyxatdan oʻtgandan 5 daqiqa oʻtib kalit yaratish mumkin. Har hisobda koʻpi bilan 3 ta faol kalit, har birining yorligʻi boʻladi.
- Kalit faqat yaratilganda bir marta koʻrsatiladi: faqat xeshi saqlanadi. Yoʻqolgan yoki oshkor boʻlgan kalit bir bosishda bekor qilinib, yangisiga almashtiriladi.
Kalitni yuborish
Kalitni Authorization sarlavhasida Bearer sxemasi bilan yoki X-Api-Key sarlavhasida yuboring. Kalitlar faqat /api/v1’da oʻqiladi; ularni brauzer kodi va ochiq repozitoriylarga qoʻymang.
Javob sarlavhalari va xatolar
- X-RateLimit-Limit
- daqiqalik soʻrov kvotasi
- X-RateLimit-Remaining
- joriy davrda qolgan soʻrovlar
- X-RateLimit-Reset
- davr yangilanishigacha soniyalar
Xato yozilgan, nomaʼlum yoki bekor qilingan kalit eʼtiborsiz qoldirilmaydi: anonim cheklovlarga oʻtish oʻrniga soʻrov WWW-Authenticate bilan 401 oladi. Bloklangan hisob kaliti 403 oladi. Cheklovdan oshganda Retry-After bilan 429 qaytariladi.
Soʻrov misollari
Kalit bilan narxlar
curl -H "X-Api-Key: $SKINORY_API_KEY" \
"https://skinory.io/api/v1/price?q=AK-47%20%7C%20Redline" Kalit bilan bitta inventar
/api/v1/inventory’ga SteamID64, profil havolasi yoki shaxsiy nom yuboring. Inventar ochiq boʻlishi kerak. Soʻrov 25 soniyagacha kutishi, saqlangan bahoni (stale: true) yoki Retry-After bilan 503 qaytarishi mumkin. Baholash vaqtini checkedAt’dan tekshiring.
curl --include -H "Authorization: Bearer $SKINORY_API_KEY" \
"https://skinory.io/api/v1/inventory?steam=76561197960287930" Saqlangan inventarlarni jamlab olish
Vergul bilan ajratilgan 100 tagacha SteamID64 yoki /profiles/ havolasini yuboring. /api/v1/inventories Steam’ga ulanmasdan saqlangan baholarni oʻqiydi. cached holati saqlangan baho borligini, unknown esa yoʻqligini bildiradi. Baholashni /api/v1/inventory orqali soʻrang.
curl -H "X-Api-Key: $SKINORY_API_KEY" \
"https://skinory.io/api/v1/inventories?steam=76561198132414056,76561197960287930" Bitta soʻrovda barcha TF2 narxlari
curl --compressed -H "X-Api-Key: $SKINORY_API_KEY" \
"https://skinory.io/api/v1/games/tf2/prices" 429 — API chekloviga yetildi; 503 — baholash kutilmoqda yoki Steam soʻrovlarni vaqtincha cheklamoqda. Retry-After’dagi soniyalarning hammasini, bir daqiqadan oshsa ham kuting va bir profilni parallel qayta soʻramang.
Narxlar yangiligi
/api/v1/price, /api/v1/offers hamda /api/v1/games ostidagi Dota 2, Rust va TF2 narxlari kamida 6 soat kechikadi. pricedAt, snapshotAt va stale maydonlarini tekshiring; bular jonli kotirovkalar emas. Kechiktirilgan qayd tayyor boʻlmasa, API Retry-After bilan 503 qaytaradi. Inventar baholarining alohida checkedAt vaqti bor.
API manzillari
Usullar va parametrlar OpenAPI’dan olinadi. * bilan belgilangan parametrlar majburiy. Toʻliq javob sxemalari spetsifikatsiyada.
| API manzili | Qaytaradigan maʼlumot | Parametrlar |
|---|---|---|
GET /api/v1/droppool API kaliti | Kuzatiladigan haftalik CS2 drop havzasi | — |
GET /api/v1/status API kaliti | Narx oqimlari va maʼlumot toʻplamlarining yangilanish vaqtlari | — |
GET /api/v1/index | Toifalar boʻyicha soʻnggi CS2 bozor indeksi va kapitallashuvi | lang |
GET /api/v1/index/history | Bitta toifaning kunlik CS2 bozor indeksi tarixi | categorydayslang |
GET /api/v1/inventory API kaliti | Ochiq Steam inventarini baholash: CS2, Dota 2, Rust va TF2 | steam*lang |
GET /api/v1/inventories API kaliti | Bitta soʻrovda 100 tagacha Steam inventarining saqlangan baholari | steam*lang |
GET /api/v1/price API kaliti | CS2 buyumlarini nomi boʻyicha topish; narxlar kamida 6 soat kechikadi | q*langcurrency |
GET /api/v1/price/history API kaliti | Bitta CS2 buyumining kunlik narx tarixi | q*dayslang |
GET /api/v1/offers API kaliti | Bitta CS2 buyumi uchun bozor takliflari, kamida 6 soat kechikish bilan | name*lang |
GET /api/v1/games/{game} API kaliti | Dota 2, Rust yoki TF2 katalogi: filtrlar va narx manbalari | game*lang |
GET /api/v1/games/{game}/items API kaliti | Dota 2, Rust yoki TF2 buyumlari; narxlar kamida 6 soat kechikadi | game*qnameheroraritytypequalityslotcategoryitemclasssortpagelimitlang |
GET /api/v1/games/{game}/items/{slug} API kaliti | Bitta Dota 2, Rust yoki TF2 buyumi va bozor takliflari, kamida 6 soat kechikish bilan | game*slug*lang |
GET /api/v1/games/{game}/prices API kaliti | Bitta oʻyinning barcha narxlari bitta javobda, kamida 6 soat kechikish bilan | game* |
GET /api/v1/float | Koʻrish havolasidan CS2 buyumining float, seed, stiker va breloki | url*lang |
GET /api/v1/teams API kaliti | Rasmiy Valve reytingidagi CS2 jamoalari | region |
GET /api/v1/teams/{slug} API kaliti | Jamoa profili: tarkib, sovrinlar, oʻyinlar va reyting tarixi | slug* |
GET /api/v1/players API kaliti | Valve reytingidagi jamoalar oʻyinchilari | steamlimit |
GET /api/v1/players/{slug} API kaliti | Oʻyinchi profili va joriy jamoasi | slug* |
AI yordamchilari uchun alohida kirish
Tanilgan AI yordamchilari inventarlardan kalitsiz foydalana oladi. Soʻrov kvotalari IP boʻyicha; ilk qidiruvlar barcha yordamchilarga umumiy byudjetdan olinadi. Jamlangan soʻrovda 50 tagacha profil boʻlishi mumkin. Bular shaxsiy kalitingiz cheklovlari emas.
- /api/v1’da tanilgan AI yordamchilarining daqiqalik soʻrovlari
- 120
- Har IP uchun soatlik inventar soʻrovlari
- 240
- Barcha AI yordamchilariga umumiy, ilgari baholanmagan profillarning daqiqalik qidiruvlari
- 32
Spetsifikatsiya va mashina oʻqiydigan fayllar
/api/openapi.jsonOpenAPI 3.1 spetsifikatsiyasi: parametrlar, javob sxemalari va xatolar/.well-known/openapi.jsonstandart well-known manzilidagi shu spetsifikatsiya/llms.txtAI yordamchilari uchun URL namunalari va API misollari bilan sayt tavsifi/llms-full.txtbarcha inglizcha matnli qoʻllanmalar bitta Markdown faylida/llms-catalog.txtCS2: eʼlonlardagi bozor qiymati boʻyicha eng yuqori 500 ta skin JSON Lines formatida, har soatda yangilanadi/.well-known/ai-catalog.jsonAI agentlari uchun imkoniyatlar manifesti- Hisoblash usuli narxlar manbasi va hisoblash usuli
Litsenziya
Qoʻllanmalar, tahririy matnlar va sayt hisoblagan maʼlumotlar (drop havzasi baholari, keys RTP’si, indekslar, kunlik medianalar, naqsh jadvallari, llms-catalog.txt toʻplami) CC BY 4.0 ostida: Skinoryni manba sahifasiga havola bilan koʻrsating.
Jamoa va oʻyinchi maʼlumotlari (/api/v1/teams, /api/v1/players) Liquipedia’dan olingan va CC BY-SA 4.0 ostida: Skinoryni havola bilan koʻrsating hamda oʻzgartirilgan nusxalarni shu litsenziyada ulashing.
Buyum kataloglari Steam va oʻyin fayllari, jumladan CS2 uchun CSGO-API maʼlumotlaridan foydalanadi. Bu materiallar va bozor narxlari uchinchi tomonlarga tegishli; asl huquq egalarining shartlari amal qiladi.
Manbani qanday koʻrsatish kerak
Sahifani «Skinory — sahifa nomi, URL, yangilanish sanasi» koʻrinishida, asosiy URL va sahifada koʻrsatilgan sana bilan keltiring; sana yoʻq boʻlsa, oʻqigan kuningizni yozing. Narxlar oʻzgaradi, shuning uchun valyuta va vaqtini ham koʻrsating.
Skinory — AK-47 | Redline, https://skinory.io/uz/items/ak-47-redline, 2026-11-19
