Хөгжүүлэгчдэд зориулсан нээлттэй API
CS2, Dota 2, Rust, TF2 үнэ, CS2 аналитик ба зах зээлийн индекс, боломжит тоглоом тус бүрийн дүнтэй Steam инвентарын үнэлгээ, CS2 баг, тоглогчдын мэдээлэл өгдөг үнэгүй, зөвхөн унших JSON API. Ихэнх эндпоинт үнэгүй хувийн API түлхүүр шаарддаг бөгөөд түлхүүр хязгаарыг мөн нэмэгдүүлнэ. Зах зээлийн индекс, флоат шалгалт түлхүүргүй ажиллана. Дэмждэг параметр, өгөгдлийг доор жагсаав.
Хөтчийн өргөтгөл
CS2 эд зүйлсээ хадгалж, үнийн өөрчлөлтийг хянаж, Steam дээрээс захуудын саналыг харьцуулаарай.
API хандалт ба хувийн хязгаар
Түлхүүргүй
Зах зээлийн индекс, флоат шалгалт нэвтрэхгүй ажиллана: IP хаяг бүрд минутад 5 хүсэлт. Үнэ, санал, өгөгдлийн төлөв, дропын сан, баг, тоглогч, инвентарт түлхүүр хэрэгтэй.
ЭндпоинтуудТүлхүүртэй
Таны скрипт, интеграцад зориулсан үнэгүй хувийн түлхүүр. Үнэ, санал, өгөгдлийн төлөв, дропын сан, баг, тоглогч, инвентарыг нээж, түлхүүр бүрд тусад нь тоологдох хязгаарыг нэмэгдүүлнэ.
Түлхүүр хэрхэн авах вэ| Хязгаар | Түлхүүргүй | Түлхүүртэй |
|---|---|---|
| Минутад хүсэлт | 5 | 120 |
| Цагт хийх инвентарын хүсэлт: дан ба багц | Түлхүүр шаардлагатай | 480 |
| Минутад хийх инвентарын анхны шалгалт | Түлхүүр шаардлагатай | 48 |
| /api/ | Түлхүүр шаардлагатай | 100 |
| /api/ | 10 | 15 |
Инвентарын цагийн квот хоёр эндпоинтыг хамарна; багц нэг хүсэлтэд тооцогдоно. stale: true-тай буцсан нэг инвентар энэ квотыг зарцуулахгүй. Анхны шалгалт нь хадгалсан үнэлгээгүй профайлын хүсэлт юм.
Нэг IP хаягаас ашигласан бүх түлхүүр аль бүртгэлд хамаарахаас үл хамааран нэг дээд хязгаар хуваалцана: минутад 240 хүсэлт, цагт 960 инвентарын хүсэлт, минутад 96 анхны шалгалт, 30 Game Coordinator шалгалт.
Түлхүүр хэрхэн авах вэ
- Steam-ээр нэвтэрч, профайлынхаа «API түлхүүрүүд» хэсгийг нээнэ үү. Профайл руу очих
- Skinory-д бүртгүүлснээс 5 минутын дараа түлхүүр үүсгэнэ үү. Нэг бүртгэл 3 хүртэл идэвхтэй түлхүүртэй байж болох бөгөөд тус бүрд нь нэр өгч болно.
- Түлхүүр зөвхөн нэг удаа, үүсгэх үед харагдана: бид зөвхөн түүний хэшийг хадгалдаг. Алдагдсан эсвэл задарсан түлхүүрийг нэг товшилтоор хүчингүй болгож, шинээр сольж болно.
Түлхүүрийг хэрхэн илгээх вэ
Түлхүүрийг Bearer схемтэй Authorization толгойд эсвэл X-Api-Key толгойд илгээнэ үү. Түлхүүрийг зөвхөн /api/v1 дээр уншдаг; хөтөч дээр ажилладаг код болон нийтийн репозиторид бүү оруулаарай.
Хариултын толгой ба алдаа
- X-RateLimit-Limit
- минутад хийх хүсэлтийн квот
- X-RateLimit-Remaining
- одоогийн цонхонд үлдсэн хүсэлт
- X-RateLimit-Reset
- цонх шинэчлэгдэх хүртэлх секунд
Буруу бичсэн, үл мэдэгдэх эсвэл хүчингүй болсон түлхүүрийг хэзээ ч үл тоомсорлодоггүй: хүсэлт нэргүй хязгаар руу шилжихийн оронд WWW-Authenticate-тэй 401 авна. Хаагдсан бүртгэлийн түлхүүр 403 авна. Хязгаар хэтэрвэл хариу нь Retry-After-тэй 429 байна.
Хүсэлтийн жишээ
Түлхүүртэй үнийн хүсэлт
curl -H "X-Api-Key: $SKINORY_API_KEY" \
"https://skinory.io/api/v1/price?q=AK-47%20%7C%20Redline" Түлхүүртэй нэг инвентар
/api/v1/inventory руу SteamID64, профайлын холбоос эсвэл тусгай нэрийг дамжуулна уу. Инвентар нээлттэй байх ёстой. Хүсэлт 25 секунд хүртэл хүлээх, хадгалсан үнэлгээ (stale: true) буцаах эсвэл Retry-After-тай 503 хариу өгөх боломжтой. Үнэлгээний цагийг checkedAt-аас шалгана уу.
curl --include -H "Authorization: Bearer $SKINORY_API_KEY" \
"https://skinory.io/api/v1/inventory?steam=76561197960287930" Хадгалсан инвентаруудын багц
Таслалаар тусгаарласан 100 хүртэл SteamID64 эсвэл /profiles/ URL дамжуулна уу. /api/v1/inventories нь Steam рүү хандахгүйгээр хадгалсан үнэлгээг уншина. cached төлөв нь хадгалсан үнэлгээ, unknown нь үнэлгээ байхгүй гэсэн үг. Шинэ үнэлгээг /api/v1/inventory-аар хүснэ үү.
curl -H "X-Api-Key: $SKINORY_API_KEY" \
"https://skinory.io/api/v1/inventories?steam=76561198132414056,76561197960287930" TF2-ийн бүх үнэ нэг хүсэлтээр
curl --compressed -H "X-Api-Key: $SKINORY_API_KEY" \
"https://skinory.io/api/v1/games/tf2/prices" 429 нь API хязгаарт хүрснийг, 503 нь үнэлгээ хүлээгдэж байгаа эсвэл Steam хүсэлтийг түр хязгаарласныг илэрхийлнэ. Retry-After-д заасан секундийг нэг минутаас их байсан ч бүтнээр нь хүлээнэ үү. Ижил профайлд зэрэгцүүлэн дахин хүсэлт бүү илгээгээрэй.
Үнийн шинэ байдал
/api/v1/price, /api/v1/offers болон /api/v1/games доторх Dota 2, Rust, TF2 эндпоинтын үнэ дор хаяж 6 цаг-ийн хоцролттой. pricedAt, snapshotAt, stale талбаруудыг шалгаарай; эдгээр нь шууд үнэ биш. Хоцролттой зураглал бэлэн биш бол API Retry-After-тай 503 буцаана. Инвентарын үнэлгээ өөрийн checkedAt цагтай.
Эндпоинтууд
Метод, параметрийг OpenAPI-ээс авсан. * тэмдэгтэй параметр заавал шаардлагатай. Хариуны бүтэн бүтцийг тодорхойлолтоос харна уу.
| Эндпоинт | Буцаах зүйл | Параметр |
|---|---|---|
GET /api/v1/droppool API түлхүүр | Хянаж буй CS2 долоо хоногийн дропын сан | — |
GET /api/v1/status API түлхүүр | Үнийн эх сурвалж, өгөгдлийн багцын шинэчилсэн цаг | — |
GET /api/v1/index | Сүүлийн CS2 зах зээлийн индекс, ангиллаар тооцсон үнэлгээ | lang |
GET /api/v1/index/history | Нэг ангиллын CS2 зах зээлийн өдрийн индексийн түүх | categorydayslang |
GET /api/v1/inventory API түлхүүр | Нээлттэй Steam инвентарыг үнэлэх: CS2, Dota 2, Rust, TF2 | steam*lang |
GET /api/v1/inventories API түлхүүр | Нэг хүсэлтээр 100 хүртэл Steam инвентарын хадгалсан үнэлгээ | steam*lang |
GET /api/v1/price API түлхүүр | CS2 зүйлийг нэрээр хайх; үнэ дор хаяж 6 цаг-ийн хоцролттой | q*langcurrency |
GET /api/v1/price/history API түлхүүр | Нэг CS2 зүйлийн өдөр тутмын үнийн түүх | q*dayslang |
GET /api/v1/offers API түлхүүр | Нэг CS2 зүйлийн маркетын санал, дор хаяж 6 цаг-ийн хоцролттой | name*lang |
GET /api/v1/games/{game} API түлхүүр | Dota 2, Rust эсвэл TF2 каталог: шүүлтүүр, үнийн эх сурвалж | game*lang |
GET /api/v1/games/{game}/items API түлхүүр | Dota 2, Rust эсвэл TF2 зүйлс; үнэ дор хаяж 6 цаг-ийн хоцролттой | game*qnameheroraritytypequalityslotcategoryitemclasssortpagelimitlang |
GET /api/v1/games/{game}/items/{slug} API түлхүүр | Нэг Dota 2, Rust эсвэл TF2 зүйл, маркетын саналтай, дор хаяж 6 цаг-ийн хоцролттой | game*slug*lang |
GET /api/v1/games/{game}/prices API түлхүүр | Нэг тоглоомын бүх үнэ нэг хариунд, дор хаяж 6 цаг-ийн хоцролттой | game* |
GET /api/v1/float | Inspect холбоосоор CS2 зүйлийн флоат, seed, стикер, зүүлт | url*lang |
GET /api/v1/teams API түлхүүр | Valve-ийн албан ёсны чансаан дахь CS2 багууд | region |
GET /api/v1/teams/{slug} API түлхүүр | Багийн профайл: бүрэлдэхүүн, цом, тоглолт, чансааны түүх | slug* |
GET /api/v1/players API түлхүүр | Valve чансааны багуудын тоглогчид | steamlimit |
GET /api/v1/players/{slug} API түлхүүр | Тоглогчийн профайл, одоогийн баг | slug* |
AI туслахуудад зориулсан тусдаа хандалт
Танигдсан AI туслахууд инвентарыг түлхүүргүй шалгаж болно. Хүсэлтийн квот IP хаяг тус бүрд үйлчилнэ; анхны шалгалтууд бүх туслахын хувьд нэг квот хуваалцана. Нэг багцад 50 хүртэл профайл байж болно. Эдгээр нь таны хувийн түлхүүрийн хязгаар биш.
- /api/v1 дээр мэдэгдэж буй AI туслахуудын минутад хүсэлт
- 120
- Нэг IP хаягаас цагт хийх инвентарын хүсэлт
- 240
- Хэзээ ч үнэлэгдээгүй профайлын минутад хайлт, бүх AI туслахын нийтлэг төсөв
- 32
Тодорхойлолт ба машинаар уншигдах файлууд
/api/openapi.jsonOpenAPI 3.1 тодорхойлолт: параметр, хариуны схем, алдаа/.well-known/openapi.jsonижил тодорхойлолт well-known хаяг дээр/llms.txtAI туслахуудад зориулсан URL загвар, API жор бүхий сайтын тойм/llms-full.txtангли хэл дээрх бүх текст гарын авлага нэг Markdown файлд/llms-catalog.txtCS2: зарын нийт үнээр тэргүүлэх 500 скин, JSON Lines хэлбэрээр, цаг тутам шинэчлэгдэнэ/.well-known/ai-catalog.jsonAI агентуудад зориулсан чадварын манифест- Арга зүй үнэ хаанаас ирж, хэрхэн тооцогддог
Лиценз
Гарын авлага, редакцийн бичвэр болон сайтын өөрийн гаргасан өгөгдөл (дроп пулын тооцоо, кейсийн RTP, индекс, өдрийн медиан, хээний хүснэгт, llms-catalog.txt эмхэтгэл) CC BY 4.0 лицензтэй: Skinory-ийг эх хуудасны холбоостой нь дурдана уу.
Баг ба тоглогчдын өгөгдөл (/api/v1/teams, /api/v1/players) Liquipedia-гаас гаралтай бөгөөд CC BY-SA 4.0 лицензтэй: Skinory-ийг холбоостой нь дурдаж, боловсруулсан хувилбарыг ижил лицензээр түгээнэ үү.
Зүйлсийн каталогт Steam, тоглоомын файлуудын өгөгдөл, CS2-ийн хувьд CSGO-API-г ашиглана. Эдгээр материал болон маркетын үнэ гуравдагч талаас ирдэг; анхны эрх эзэмшигчийн нөхцөл үйлчилнэ.
Хэрхэн иш татах
Хуудсыг «Skinory — хуудасны гарчиг, URL, шинэчилсэн огноо» хэлбэрээр, каноник URL болон хуудсан дээрх огноогоор, огноо байхгүй бол уншсан өдрөөр иш татна уу. Үнийг валют, цагийн хамт өгнө үү: үнэ өөрчлөгддөг.
Skinory — AK-47 | Redline, https://skinory.io/mn/items/ak-47-redline, 2026-11-19
