GET/v1/schema/items/:idOrNameDEVELOPER+

单件饰品 schema

单件饰品的 schema 记录：类别、收藏品、容器、变体结构、磨损区间、图片以及各市场的目录 id。接受规范饰品 id（即价格类接口返回的 id）或 URL 编码的 market_hash_name，因此也可用来把一行价格数据关联到其背后的饰品。

两种标识符都可以：价格、NBBO 与流动性响应返回的规范 id，或 URL 编码的 market_hash_name。因此它是价格行与其背后饰品之间的关联点，只需一次小调用，无需下载完整快照。

参数

idOrNamestring必填

路径段。规范饰品 id 或 URL 编码的 market_hash_name。

响应字段

SchemaItemLookup单件饰品，只附带它所引用的注册表条目。

schemaVersioninteger

该饰品最近一次变更时的版本号（毫秒时间戳）。

itemSchemaItem

该饰品的目录记录。

registriesobjectnullable

{ rarities, collections, containers }，只包含该饰品引用的条目。

错误

404没有饰品与给定的 id 或名称匹配。

401缺少 Authorization 头、认证方案不支持，或密钥未知、未激活、已过期、已吊销。

403密钥有效，但订阅未激活/已过期，或套餐不含此接口。

429超出速率限制；见 Retry-After 与 X-RateLimit-* 响应头。配额按账号合并计算，所有密钥共享。

5xx上游快照不可用或服务端问题。请退避后重试。

另见完整 schema 快照价格快照

使用此端点的指南（英文）

export SKINPRICER_API_KEY="sp_live_•••"

curl "https://pricing.skinpricer.com/v1/schema/items/AK-47%20%7C%20Redline%20(Field-Tested)" \
  -H "Authorization: ApiKey $SKINPRICER_API_KEY"

// No SDK helper for this endpoint yet, so call it directly.
const url = new URL("https://pricing.skinpricer.com/v1/schema/items/AK-47%20%7C%20Redline%20(Field-Tested)");

const res = await fetch(url, {
  headers: { Authorization: `ApiKey ${process.env.SKINPRICER_API_KEY}` },
});
if (!res.ok) throw new Error(`HTTP ${res.status}`);
console.log(await res.json());

import os
import requests

res = requests.get(
    "https://pricing.skinpricer.com/v1/schema/items/AK-47%20%7C%20Redline%20(Field-Tested)",
    headers={"Authorization": f"ApiKey {os.environ['SKINPRICER_API_KEY']}"},
    timeout=10,
)
res.raise_for_status()
print(res.json())

需要认证的接口：请在你自己的客户端中携带 API 密钥调用（见代码示例）。

响应 200

{
  "schemaVersion": 1783069455007,
  "item": {
    "id": "cmlofcu700pem01yop1965ua2",
    "marketHashName": "★ Karambit | Doppler (Factory New)",
    "slug": "karambit-doppler-factory-new",
    "category": "skin",
    "baseName": "★ Karambit | Doppler",
    "weapon": "Karambit",
    "finish": "Doppler",
    "rarity": "covert",
    "wear": "Factory New",
    "wears": ["Factory New", "Minimal Wear"],
    "stattrak": false,
    "souvenir": false,
    "hasStattrak": true,
    "hasSouvenir": false,
    "variants": [
      {
        "marketHashName": "★ Karambit | Doppler (Factory New) - Phase 1",
        "family": "doppler",
        "name": "Phase 1",
        "phase": 1,
        "image": "https://community.akamai.steamstatic.com/economy/image/..."
      },
      {
        "marketHashName": "★ Karambit | Doppler (Factory New) - Phase 2",
        "family": "doppler",
        "name": "Phase 2",
        "phase": 2,
        "image": "https://community.akamai.steamstatic.com/economy/image/..."
      },
      {
        "marketHashName": "★ Karambit | Doppler (Factory New) - Phase 3",
        "family": "doppler",
        "name": "Phase 3",
        "phase": 3,
        "image": "https://community.akamai.steamstatic.com/economy/image/..."
      },
      {
        "marketHashName": "★ Karambit | Doppler (Factory New) - Phase 4",
        "family": "doppler",
        "name": "Phase 4",
        "phase": 4,
        "image": "https://community.akamai.steamstatic.com/economy/image/..."
      },
      {
        "marketHashName": "★ Karambit | Doppler (Factory New) - Black Pearl",
        "family": "doppler",
        "name": "Black Pearl",
        "image": "https://community.akamai.steamstatic.com/economy/image/..."
      },
      {
        "marketHashName": "★ Karambit | Doppler (Factory New) - Ruby",
        "family": "doppler",
        "name": "Ruby",
        "image": "https://community.akamai.steamstatic.com/economy/image/..."
      },
      {
        "marketHashName": "★ Karambit | Doppler (Factory New) - Sapphire",
        "family": "doppler",
        "name": "Sapphire",
        "image": "https://community.akamai.steamstatic.com/economy/image/..."
      }
    ],
    "image": "https://community.akamai.steamstatic.com/economy/image/...",
    "ids": { "buff163": "42998", "marketcsgo": "★ Karambit | Doppler (Factory New)" }
  },
  "registries": {
    "rarities": [{ "key": "covert", "name": "Covert", "tier": 6, "color": "#eb4b4b" }],
    "collections": {},
    "containers": {}
  }
}

响应头

X-RateLimit-Limit: <每分钟配额，由套餐决定>

X-RateLimit-Remaining: <本分钟剩余次数>

X-RateLimit-Reset: <距重置的秒数>

X-RateLimit-Remaining-Month: <本月剩余次数，仅限有月度上限的套餐>

X-Request-ID: req_xxxxxxxxxxxxxxxx