Skip to main content
GET
Full price-list snapshot (gzipped NDJSON)
snapshot 端点以单个 gzip 压缩的 NDJSON 文件形式提供完整的 CSBoard 价格列表。解压后的每一行都是一个 PriceRow JSON 对象——与 GET /v1/prices 返回的模式相同。它专为全目录消费者设计,如比价站点、套利机器人或需要完整本地价格列表副本的数据管道。如果只是对部分商品进行有针对性的查询,请改用 GET /v1/prices 需要身份验证。 请将密钥作为 Authorization: Bearer csb_pub_... 发送。 速率限制: 每分钟 1 次请求,独立于一般的 30 次/分钟限制。请相应规划您的轮询间隔。

请求头

string
传入上一次快照响应中的 ETag 值,以发起条件请求。如果自该 ETag 以来快照未发生变化,服务器将返回 304 Not Modified 且无响应体,从而节省带宽并避免一次新的下载。

响应头

响应体

一个 gzip 压缩的数据流。解压后,每个以换行分隔的行都是一个符合 PriceRow 模式的有效 JSON 对象:

示例:下载并查看

解压输出示例:

示例:使用 ETag 的条件请求

首次下载时,您会收到一个 ETag 响应头。在后续请求中将其传回,可避免重新下载未变化的快照:
304 Not Modified 响应意味着快照与您本地已有的副本完全一致——无需重新下载。

错误代码

请始终保存每次成功下载时返回的 ETag,并在下次请求时作为 If-None-Match 发回。304 响应不会消耗您的速率限制配额,并能让您的本地副本保持最新而无需不必要的重新下载。
此端点专为全目录摄取设计。如果您只需要特定商品或经过过滤的子集的价格,请改用 GET /v1/prices——它支持 search、category 和 wear 过滤,且不会计入快照速率限制。

授权

Authorization
string
header
必填

Send your key as a Bearer token on every request: Authorization: Bearer csb_pub_.... Generate keys in your CSBoard profile.

请求头

If-None-Match
string

Conditional request. Pass the ETag from a previous snapshot to receive 304 if unchanged.

响应

Gzipped NDJSON stream. Each decompressed line is one PriceRow JSON object. Sets an ETag header.

The response is of type file.