Хөгжүүлэгчдэд зориулсан нээлттэй API

CS2 эд зүйлсийн үнэ, Steam инвентарийн үнэлгээ, про баг ба тоглогчдын мэдээлэл өгдөг үнэгүй, зөвхөн уншдаг JSON API. Түлхүүр, бүртгэлгүйгээр ажилладаг, CORS нээлттэй, үнэ АНУ-ын доллараар, ойролцоогоор цаг тутам шинэчлэгдэнэ. Профайлаасаа авах үнэгүй түлхүүр хязгаарыг нэмэгдүүлнэ.

Эндпоинтууд

Хүснэгтийг OpenAPI баримтаас үүсгэдэг; тайлбар нь англиар. * тэмдэгтэй параметр заавал шаардлагатай.

Эндпоинт	Буцаах зүйл	Параметр
GET `/api/v1/inventory`	Appraise a public CS2 Steam inventory	`steam*lang`
GET `/api/v1/inventories`	Stored appraisals of up to 50 Steam inventories in one call (200 with an API key)	`steam*lang`
GET `/api/v1/price`	Find CS2 items by name and get their current prices	`q*lang`
GET `/api/v1/price/history`	Daily price history of one CS2 item	`q*dayslang`
GET `/api/v1/teams`	Top CS2 teams by the official Valve ranking	`region`
GET `/api/v1/teams/{slug}`	Team profile: roster, trophies, current events, recent matches, map stats and rank history	`slug*`
GET `/api/v1/players`	Players of the ranked teams, optionally only those with a public Steam profile	`steamlimit`
GET `/api/v1/players/{slug}`	Player of a ranked team	`slug*`

Хязгаар

Түлхүүргүй үед хязгаарыг IP хаяг тус бүрээр тоолно; дараагийн хэсэг тэдгээрийг хувийн түлхүүрийн хязгаартай харьцуулна. User-Agent-аар нь танигддаг мэдэгдэж буй AI туслахуудад тусдаа түвшин бий:

/api/v1 дээр мэдэгдэж буй AI туслахуудын минутад хүсэлт: 600
AI туслахуудын цагт инвентарийн үнэлгээ: 600
Хэзээ ч үнэлэгдээгүй профайлын минутад хайлт, бүх AI туслахын нийтлэг төсөв: 8

Хязгаар хэтэрвэл API 429, шинэ үнэлгээ тооцоолж байх үед 503 буцаана; хоёуланд нь секундээр Retry-After байна. Тэр хугацаанд хүлээгээд нэг удаа дахин оролдоно уу.

API түлхүүрээр илүү өндөр хязгаар

Бүх эндпоинт түлхүүргүй ажилладаг. Үнэгүй хувийн түлхүүртэй бол хязгаарыг IP хаягаар бус түлхүүрээр тоолж, илүү өндөр болгоно; /api/v1/inventory ч 503 буцаахын оронд шинэ үнэлгээг 25 секунд хүртэл хүлээнэ.

Хязгаар	Түлхүүргүй	Түлхүүртэй
Минутад хүсэлт	120	600
Цагт инвентарийн үнэлгээ	60	300
Минутад хэзээ ч үнэлэгдээгүй профайл	цагийн хязгаарт багтана	30
/api/v1/inventories нэг дуудлагад профайл	50	200

Түлхүүр хэрхэн авах вэ

Steam-ээр нэвтэрч, профайлынхаа «API түлхүүрүүд» хэсгийг нээнэ үү. Профайл руу очих
Түлхүүрийг дор хаяж нэг хоногийн настай бүртгэлүүд авах боломжтой. Нэгэн зэрэг 3 хүртэл идэвхтэй түлхүүртэй байж болох бөгөөд тус бүрд нь юунд зориулсныг заасан нэр өгнө.
Түлхүүр зөвхөн нэг удаа, үүсгэх үед харагдана: бид зөвхөн түүний хэшийг хадгалдаг. Алдагдсан эсвэл задарсан түлхүүрийг нэг товшилтоор хүчингүй болгож, шинээр сольж болно.

Түлхүүрийг хэрхэн илгээх вэ

Түлхүүрийг Bearer схемтэй Authorization толгойд эсвэл X-Api-Key толгойд илгээнэ үү. Түлхүүрийг зөвхөн /api/v1 дээр уншдаг; хөтөч дээр ажилладаг код болон нийтийн репозиторид бүү оруулаарай.

curl -H "Authorization: Bearer $CS2C_KEY" \
  "https://cs2collections.net/api/v1/price?q=AK-47%20%7C%20Redline"

curl -H "X-Api-Key: $CS2C_KEY" \
  "https://cs2collections.net/api/v1/inventory?steam=76561197960287930"

Хариултын толгой ба алдаа

Буруу бичсэн, үл мэдэгдэх эсвэл хүчингүй болсон түлхүүрийг хэзээ ч үл тоомсорлодоггүй: хүсэлт нэргүй хязгаар руу шилжихийн оронд WWW-Authenticate-тэй 401 авна. Хаагдсан бүртгэлийн түлхүүр 403 авна. Хязгаар хэтэрвэл хариу нь Retry-After-тэй 429 байна.

Тодорхойлолт ба машинаар уншигдах файлууд

/api/openapi.json OpenAPI 3.1 тодорхойлолт: параметр, хариуны схем, алдаа
/.well-known/openapi.json ижил тодорхойлолт well-known хаяг дээр
/llms.txt AI туслахуудад зориулсан URL загвар, API жор бүхий сайтын тойм
/llms-full.txt англи хэл дээрх бүх текст гарын авлага нэг Markdown файлд
/llms-catalog.txt зарын зах зээлийн үнэ цэнээр эхний 500 скин, JSON Lines хэлбэрээр, цаг тутам шинэчлэгдэнэ
/.well-known/ai-catalog.json AI агентуудад зориулсан чадварын манифест
Арга зүй үнэ хаанаас ирж, хэрхэн тооцогддог

Лиценз

Гарын авлага, редакцийн бичвэр болон сайтын өөрийн гаргасан өгөгдөл (дроп пулын тооцоо, кейсийн RTP, индекс, өдрийн медиан, хээний хүснэгт, llms-catalog.txt эмхэтгэл) CC BY 4.0 лицензтэй: CS2Collections.net-ийг эх хуудасны холбоостой нь дурдана уу.

Баг ба тоглогчдын өгөгдөл (/api/v1/teams, /api/v1/players) Liquipedia-гаас гаралтай бөгөөд CC BY-SA 4.0 лицензтэй: CS2Collections.net-ийг холбоостой нь дурдаж, боловсруулсан хувилбарыг ижил лицензээр түгээнэ үү.

Эд зүйлсийн каталог (CSGO-API өгөгдлийн багцаар дамжуулан тоглоомын файлаас авсан нэр, зураг, ховордол, цуглуулга) болон маркетын үнэ нь гуравдагч талын өгөгдөл. Сайт тэдгээрт лиценз зарлаагүй; эх сурвалжийн нөхцөл үйлчилнэ.

CC BY 4.0 ↗ · CC BY-SA 4.0 ↗

Хэрхэн иш татах

Хуудсыг «CS2Collections.net — хуудасны гарчиг, URL, шинэчилсэн огноо» хэлбэрээр, каноник URL болон хуудсан дээрх огноогоор, огноо байхгүй бол уншсан өдрөөр иш татна уу. Үнийг валют, цагийн хамт өгнө үү: үнэ өөрчлөгддөг.

CS2Collections.net — AK-47 | Redline, https://cs2collections.net/mn/items/ak-47-redline, 2026-09-27