GET /v1/schema

本页内容

访问
请求
响应
响应字段
错误

返回一份包含所有 Counter-Strike 2 饰品的完整 schema。它会在游戏更新时自动更新，包含约 47,500 件饰品和约 110 个收藏品，按 market_hash_name 键控，并提供稀有度、磨损与浮动区间、市场 id 和饰品图片。

支持变体。所有饰品都会映射回各自对应的收藏品 / 容器。

访问#

适用于所有套餐，包括 Demo 和 Developer。

请求#

GETapi.cs2.sh/v1/schema

curl https://api.cs2.sh/v1/schema \
  -H "Authorization: Bearer <<YOUR_API_KEY>>" \
  -H "Accept-Encoding: gzip" --compressed

响应#

json

{
  "schema_version": "v3",
  "generation_id": "2809027269665125439-421658e3845c",
  "generated_at": "2026-07-09T20:41:13Z",
  "counts": {
    "items": 47810,
    "by_category": {
      "skin": 21924,
      "sticker": 10555,
      "container": 480,
      "...": "..."
    },
    "collections": 110
  },
  "rarities": [
    {
      "key": "legendary",
      "name": "Classified",
      "tier": 5,
      "color": "#d32ce6"
    },
    "..."
  ],
  "collections": {
    "The Phoenix Collection": {
      "name": "The Phoenix Collection",
      "kind": "weapon",
      "release_date": "2014-02-20",
      "image": "https://cs2.sh/image/03h7unuCq0G9LG7e"
    },
    "...": "..."
  },
  "items": {
    "AK-47 | Redline (Field-Tested)": {
      "market_hash_name": "AK-47 | Redline (Field-Tested)",
      "category": "skin",
      "image": "https://cs2.sh/image/C0x6zwlC-fAu6Oob",
      "steam_image": "https://community.fastly.steamstatic.com/economy/image/i0CoZ81Ui0m-9KwlBY1L_18myuGuq1wfhWSaZgMttyVfPaERSR0Wqmu7LAocGIGz3UqlXOLrxM-vMGmW8VNxu5Dx60noTyLwlcK3wiFO0POlPPNSI_-RHGavzOtyufRkASq2lkxx4W-HnNyqJC3FZwYoC5p0Q7FfthW6wdWxPu-371Pdit5HnyXgznQeHYY5wyA",
      "is_tradable": true,
      "rarity": {
        "name": "Classified",
        "tier": 5,
        "color": "#d32ce6"
      },
      "collections": [
        "The Phoenix Collection"
      ],
      "containers": [
        "Operation Phoenix Weapon Case"
      ],
      "ids": {
        "buff": 33960,
        "youpin": 1414,
        "c5game": 22499
      },
      "def_index": 7,
      "base_name": "AK-47 | Redline",
      "weapon": "AK-47",
      "finish": "Redline",
      "paint_index": 282,
      "wears": [
        "Minimal Wear",
        "Field-Tested",
        "Well-Worn",
        "Battle-Scarred"
      ],
      "has_stattrak": true,
      "has_souvenir": true,
      "float_range": {
        "min": 0.1,
        "max": 0.7
      },
      "wear": "Field-Tested",
      "stattrak": false,
      "souvenir": false
    },
    "★ Karambit | Doppler (Factory New)": {
      "market_hash_name": "★ Karambit | Doppler (Factory New)",
      "category": "skin",
      "image": "https://cs2.sh/image/vJQM7YiSwMZS1GsE",
      "steam_image": "https://community.fastly.steamstatic.com/economy/image/i0CoZ81Ui0m-9KwlBY1L_18myuGuq1wfhWSaZgMttyVfPaERSR0Wqmu7LAocGIGz3UqlXOLrxM-vMGmW8VNxu5Dx60noTyL6kJ_m-B1Q7uCvZaZkNM-SA1iSze91u_FsTju_qhAmoT-Jn4bjJC_4Ml93UtZuRLQPsBawkNfiMbnl5AKMiopCnin7iCJBv31j4rkBBKEg-6zUjV3GY6p9v8dpLWT3Fg",
      "def_index": 507,
      "wear": "Factory New",
      "float_range": {
        "min": 0,
        "max": 0.08
      },
      "...": "...",
      "variants": [
        {
          "market_hash_name": "★ Karambit | Doppler (Factory New) | Phase 2",
          "family": "doppler",
          "name": "Phase 2",
          "phase": "Phase 2",
          "color": "#d63384",
          "paint_index": 419,
          "image": "https://cs2.sh/image/ccWlpNQFHEc0WC8X",
          "steam_image": "https://community.fastly.steamstatic.com/economy/image/i0CoZ81Ui0m-9KwlBY1L_18myuGuq1wfhWSaZgMttyVfPaERSR0Wqmu7LAocGIGz3UqlXOLrxM-vMGmW8VNxu5Dx60noTyL6kJ_m-B1Q7uCvZaZkNM-SA1iUzv5mvOR7cDm7lA4i4QKJk4jxNWWXawUgA8dxRLEO40KwkobnMbnj5QKL348Qmy-sji5K7i466uxUUKQn5OSJ2KBZjkQR"
        },
        "..."
      ]
    },
    "★ Karambit | Doppler (Factory New) | Phase 2": {
      "market_hash_name": "★ Karambit | Doppler (Factory New) | Phase 2",
      "category": "skin",
      "image": "https://cs2.sh/image/ccWlpNQFHEc0WC8X",
      "steam_image": "https://community.fastly.steamstatic.com/economy/image/i0CoZ81Ui0m-9KwlBY1L_18myuGuq1wfhWSaZgMttyVfPaERSR0Wqmu7LAocGIGz3UqlXOLrxM-vMGmW8VNxu5Dx60noTyL6kJ_m-B1Q7uCvZaZkNM-SA1iUzv5mvOR7cDm7lA4i4QKJk4jxNWWXawUgA8dxRLEO40KwkobnMbnj5QKL348Qmy-sji5K7i466uxUUKQn5OSJ2KBZjkQR",
      "def_index": 507,
      "wear": "Factory New",
      "variant": {
        "family": "doppler",
        "name": "Phase 2",
        "of": "★ Karambit | Doppler (Factory New)"
      },
      "phase": "Phase 2",
      "color": "#d63384",
      "paint_index": 419,
      "...": "..."
    },
    "...": "..."
  }
}

返回 SchemaResponse 对象。完整结构见对象。

响应字段#

items 将每个 market_hash_name 映射到其目录记录––与价格端点所接受的名称一致。collections 和 rarities 描述这些记录所引用的收藏品与稀有度分层。

不适用于某件饰品的字段会被省略。
generation_id 是必需的增量顶层字段，用于标识 API 与 site-data 共享的不可变目录。能够容忍未知 JSON 字段的客户端仍与旧响应结构兼容。
ids 在已知时提供 buff、youpin 和 c5game 目录 id。
def_index 和 paint_index 是游戏的饰品定义索引和涂装索引；Doppler 和 Gamma Doppler 基础饰品会省略 paint_index – 每个阶段行都带有各自的索引。
image 是每件饰品和每个嵌套变体都必需的 cs2.sh 自有图片。steam_image 是可选字段，仅在管道能独立证明精确的 Valve Economy/static 官方来源时提供；省略 steam_image 并不代表饰品失去了图片。
带变体的基础饰品会在 variants 下列出变体；变体行通过 variant 回链。
对无法交易的饰品，is_tradable 为 false。

成功响应带有 ETag 和一小时公共缓存标头。发送上次的 ETag 作为 If-None-Match；如果 generation 未变化，将收到响应体为空的 304 Not Modified。

完整结构：SchemaItem、SchemaItemVariant、SchemaCollection 和 SchemaRarity。

错误#

状态	触发条件
`400`	不接受查询参数，或缺少 `Accept-Encoding: gzip`。
`401`	缺少密钥或密钥无效。
`429`	触发限流。
`503` / `5xx`	目录不可用或服务端问题。