天气查询
https://api.fohok.xin/v1/weather接口说明
城市天气查询,支持经纬度查询
请求参数
| 参数名 | 位置 | 类型 | 必填 | 示例 |
|---|---|---|---|---|
| q | body | string | 必填 | 北京 |
| 城市名从此传入,支持经纬度传入 | ||||
| v | body | string | 可选 | 2 |
| 1为精简版,2为完整版,默认为1 | ||||
| scene | body | string | 可选 | typhoon |
| 仅识别 typhoon=活动台风详情和 typhoon_history=全年台风列表 两个值 | ||||
| basin | body | string | 可选 | NP |
| 空则置NP,非NP返回 40001 basin 仅支持 NP(西北太平洋) | ||||
| year | body | string | 可选 | 2026 |
| 空则取当前年 | ||||
| id | body | string | 可选 | NP_2601 |
请求示例
curl
curl -X GET 'https://api.fohok.xin/v1/weather' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"q":"北京","v":"2","scene":"typhoon","basin":"NP","year":"2026","id":"NP_2601"}'
响应说明
| 字段 | 类型 | 说明 |
|---|---|---|
| code | int | 业务状态码,0 表示成功 |
| msg | string | 状态描述 |
| data | object | 业务数据,由上游接口决定 |
| request_id | string | 本次请求唯一标识,可用于问题排查 |
| cost_ms | float | 网关侧处理耗时(毫秒) |
响应头附带 X-Request-Id、X-Response-Time、X-Billing-Mode、X-Billing-Tier、X-Token-Cost,便于对账与性能观测。
计费与价梯
| 价梯 | 累计区间 | 单价(Token) | 说明 |
|---|---|---|---|
| 第 1 档 | 0 – 500 次 | 0.0023 / 次 | 起步价 |
| 第 2 档 | 500 – 1,000 次 | 0.0019 / 次 | 累计用量进入本档后按此价 |
| 第 3 档 | 1,000 以上 次 | 0.0000 / 次 | 最高档,超出仍按此价 |
累计量按「当前 Key × 该接口」单独统计:你换一个 Key、或调另一个接口,都从各自的累计量算起,互不影响;用量越大单价越低。
每次调用都会在响应头返回 X-Billing-Tier,标明本次消耗归属的价梯档位。
错误码
| HTTP | error | 说明 |
|---|---|---|
| 400 | bad_request | 请求参数不合法 |
| 401 | missing_api_key / invalid_api_key | 缺少或无效的 API Key |
| 402 | insufficient_balance | Token 余额不足 |
| 403 | api_key_disabled / ip_not_allowed | Key 被禁用或 IP 不在白名单 |
| 429 | rate_limited / daily_limit_exceeded | 触发限流或当日额度用尽 |
| 503 | server_busy / queue_timeout | 并发超限排队超时 |
| 502 | upstream_error | 上游服务异常 |