Skip to main content
GET
Liveness + freshness probe
health 端点是一个轻量级探针,用于确认 API 是否可达,并告诉您实体化的价格列表有多陈旧。它是唯一无需 API 密钥即可工作的端点,因此非常适合从监控系统轮询,或在执行已认证调用前在应用启动阶段进行新鲜度检查。

响应字段

string
必填
服务正常时始终为 "ok"
integer
必填
当前价格列表中已定价的商品组数量(每个唯一的 market_hash_name + wear + doppler_phase 组合算一组)。
integer
必填
实体化价格列表的年龄,以秒为单位。请将其作为新鲜度指标——数值过大意味着价格可能滞后。

示例请求

示例响应

错误代码

在执行已认证调用之前,请在健康检查或启动逻辑中轮询此端点。如果 price_list_age_seconds 出乎意料地大(例如超过几分钟),请将下游价格数据视为可能已陈旧。

响应

200 - application/json

Service is up.

status
string
必填
示例:

"ok"

groups
integer
必填

Count of priced item groups.

price_list_age_seconds
integer
必填

Age of the materialized price list, in seconds (freshness).