服务健康探活 · StockRoute

服务健康探活 GET /api/health 无需鉴权

接口:health——返回中台服务版本、活跃数据集数与 A 股核心覆盖率。用于负载均衡探活与可用性监控,也可作为接入的第一步连通性验证。

限量:单次返回 1 条概要;建议探活间隔 ≥30s。

权限:无需鉴权,不计入限速与月配额。档位说明 →

输出参数

名称	类型	默认显示	描述
`status`	str	Y	ok=正常 / degraded=降级(依赖异常但服务存活)
`version`	str	Y	API 版本号(如 0.2.1-M3)
`time`	str	Y	服务器当前时间(ISO 格式,东八区)
`datasets_active`	int	Y	活跃数据集数(在产数据集)
`datasets_total`	int	Y	登记数据集总数(含 planned)
`coverage_a_core`	float	Y	A股核心数据覆盖率(%),质量分舱依据

units 口径随每个响应返回——消费方据此判 45 是 45% 还是 0.45,不必猜。

接口示例

curl https://api-stock.600044.xyz/api/health

数据样例 (真实数据:贵州茅台 600519)

`status` ok=正常 / degraded=降	`version` API 版本号(如 0.2.1-M3	`time` 服务器当前时间(ISO 格式,东八区	`datasets_active` 活跃数据集数(在产数据集)	`datasets_total` 登记数据集总数(含 planned)	`coverage_a_core` A股核心数据覆盖率(%),质量分舱依
ok	0.2.1-M3	2026-09-15T19:31:06	91	92	82.1

[
  {
    "coverage_a_core": 82.1,
    "datasets_active": 91,
    "datasets_total": 92,
    "status": "ok",
    "time": "2026-09-15T19:31:06",
    "version": "0.2.1-M3"
  }
]

表头第二行为字段含义(悬停无截断完整版见上方「输出参数表」);首列固定,横向滚动查看更多字段。

注意事项

degraded 状态仍返回 200,请按 status 字段而非 HTTP 码判健康。

← 返回接口列表 · 错误码:401 无效token / 403 需会员(该数据集基础档起) / 404 无数据 / 422 缺必填 / 429 限速或月配额 / 503 授权暂不可用(fail-closed)