天气查询

GET 天气查询 QPS ≤ 3 并发 ≤ 100 运行中
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,便于对账与性能观测。

计费与价梯

计费模式按次扣费per_call 计量单位次 统计周期按月
价梯累计区间单价(Token)说明
第 1 档 0 – 500 次 0.0023 / 次 起步价
第 2 档 500 – 1,000 次 0.0019 / 次 累计用量进入本档后按此价
第 3 档 1,000 以上 次 0.0000 / 次 最高档,超出仍按此价

累计量按「当前 Key × 该接口」单独统计:你换一个 Key、或调另一个接口,都从各自的累计量算起,互不影响;用量越大单价越低。 每次调用都会在响应头返回 X-Billing-Tier,标明本次消耗归属的价梯档位。

错误码

HTTPerror说明
400bad_request请求参数不合法
401missing_api_key / invalid_api_key缺少或无效的 API Key
402insufficient_balanceToken 余额不足
403api_key_disabled / ip_not_allowedKey 被禁用或 IP 不在白名单
429rate_limited / daily_limit_exceeded触发限流或当日额度用尽
503server_busy / queue_timeout并发超限排队超时
502upstream_error上游服务异常
闽ICP备2026024151号 闽公网安备35058302351237号