Prometheus 提供了一套稳定的 HTTP API，默认挂载在 /api/v1 下，用于查询指标、发现序列、查看目标与规则、读取状态以及执行 TSDB 管理操作。
本文基于 Prometheus 3.x 重写，覆盖通用响应格式、查询/元数据/状态/管理 API、客户端调用、错误处理、安全与版本差异。最后复核时间：2026-10。
API 默认没有认证。生产环境必须通过反向代理、
--web.config.file、网络策略等方式保护，尤其不要暴露/-/reload、/-/quit和 TSDB 管理接口。