GET/v1/schema/changesDEVELOPER+

饰品 schema 增量变更

为 schema 镜像提供的增量目录同步：返回严格晚于 since 新增或变更的饰品，按键集分页。只有内容真正变化时饰品版本才会递增，因此平静的一天只需几百字节，而不是整个快照。请把返回的 schemaVersion 保存为下一次的 since。

只有记录内容真正变化时单件饰品的版本才会递增，因此在平静的日子里轮询几乎没有成本。在 hasMore 为真时用 nextCursor 翻页，然后把返回的 schemaVersion 保存为下一次的 since。附带的 registries 包含返回饰品所引用的稀有度、收藏品与容器条目，因此只消费增量的一方无需重新拉取快照，也不会与注册表脱节。

参数

sincestring必填

查询参数。之前返回的 schemaVersion（毫秒时间戳）或 ISO-8601 时间戳。

cursorstring可选

查询参数。上一页的 nextCursor；定位时优先于 since。

limitinteger可选

查询参数。每页最大饰品数，1 到 5000。默认 1000。

响应字段

SchemaChanges在 since 之后新增或变更的饰品，按键集分页。

schemaVersioninteger

当前全目录版本号。请保存为下一次的 since。

sinceinteger

解析后的 since 位置（毫秒时间戳）。

countinteger

本页的饰品数。

hasMoreboolean

是否还有下一页。

nextCursorstringnullable

作为 cursor 传回以获取下一页。

itemsSchemaItem[]

变更的饰品，完整记录。

registriesobjectnullable

返回饰品所引用的注册表条目；没有变化时省略。

错误

400缺少 since，或它既不是 schemaVersion 也不是 ISO-8601 时间戳；或 limit 超出范围。

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

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

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

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

另见完整 schema 快照

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

How to sync the full CS2 item catalog with float ranges and images

export SKINPRICER_API_KEY="sp_live_•••"

curl -G "https://pricing.skinpricer.com/v1/schema/changes" \
  --data-urlencode "since=1783069455007" \
  -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/changes");
url.searchParams.set("since", "1783069455007");

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/changes",
    params={"since": "1783069455007"},
    headers={"Authorization": f"ApiKey {os.environ['SKINPRICER_API_KEY']}"},
    timeout=10,
)
res.raise_for_status()
print(res.json())

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

响应 200

{
  "schemaVersion": 1783069455007,
  "since": 1782900000000,
  "count": 1,
  "hasMore": false,
  "nextCursor": null,
  "items": [
    {
      "id": "cmlofbol90hb801yozu37irb8",
      "marketHashName": "Fever Case",
      "slug": "fever-case",
      "category": "container",
      "releaseDate": "2025-02-04T00:00:00.000Z",
      "image": "https://community.fastly.steamstatic.com/economy/image/...",
      "ids": { "itrade": "ZG39o2", "swapgg": "68e9842efed1b98d8ba01b23:5" }
    }
  ]
}

响应头

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

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

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

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

X-Request-ID: req_xxxxxxxxxxxxxxxx