PeakMet OpenAPI

OpenAPI 接入控制台

PeakMet 的 OpenAPI 与网页端共享同一套时间窗口控制逻辑。开发者套餐只会暴露当前可见窗口内的数据，并要求 API Key、签名头、会员状态与白名单 IP 同时满足。

升级到 API 套餐管理 API Key

Rules

接入规则与签名方式

请求头必须携带 API Key、时间戳、随机串与签名。
请求来源必须命中绑定的固定公网 IP。
接口返回只覆盖当前时间窗口内可见的数据。

Access Policy

接入条件

先看权限边界，再接入接口。

四头鉴权

`X-API-Key`、`X-Timestamp`、`X-Nonce` 与 `X-Signature` 缺一不可。

固定时间窗口

接口响应会明确返回可见起止时间与下一次释放时间。

单 IP 白名单

一期每个 API Key 仅允许绑定一个固定公网 IP。

访问范围受限

当前只开放最近窗口，不支持任意历史范围导出。

Account Status

当前账号 API 状态

登录后可查看你距离可用 API 还差哪些前置条件。

登录后可查看当前账号的 API 状态。

Endpoints

核心接口

当前阶段优先开放最新窗口与窗口列表两个读取接口。

GET /api/open/v1/weather/{cityCode}/latest

返回当前可见窗口中的最新一条观测记录。

GET /api/open/v1/weather/{cityCode}/window?limit=120

返回当前可见窗口内的受控数据列表。

Sample Request

请求示例

curl -X GET "https://api.peakmet.io/api/open/v1/weather/BJ/latest" \
  -H "X-API-Key: pm_live_your_api_key" \
  -H "X-Timestamp: 1711411200" \
  -H "X-Nonce: random-nonce-string" \
  -H "X-Signature: hmac-sha256-of-method-path-timestamp-nonce"