免费开放 · 无需注册

权威数据,
一行请求就够。

数据取自中国气象局、NIH/NCBI、世界银行、GitHub、欧洲央行等官方来源, 统一封装成标准 JSON。全部免费,带不带 Key 都能调。

curl "https://api.whaios.com/api/v1/weather?city=北京"

接口列表

点任意一项跳到下方文档,可直接在线调试。

正在加载…

接口文档

参数、示例、返回结构,一页看完。

接入方式

两种调用姿势,选一个就行。

1

公开调用(无需 Key)

每个 IP 每分钟 20 次。适合演示、个人小工具、学习练手。 超出返回 429,等一分钟自动恢复。

2

带 Key 调用(推荐)

每分钟 60 次。Key 放 X-API-Key 请求头,或用 ?key= 参数。 目前免费发放,发邮件到 support@whaios.com 说明用途即可。

# 请求头方式
curl "https://api.whaios.com/api/v1/ip?ip=8.8.8.8" \
  -H "X-API-Key: wk_xxxxxxxx"

# 参数方式
curl "https://api.whaios.com/api/v1/ip?ip=8.8.8.8&key=wk_xxxxxxxx"

说明

·

统一响应格式

成功:{"ok":true,"data":{…}}; 失败:{"ok":false,"error":{"code":"…","message":"…"}}。 不存在「有时数组有时对象」的情况。

·

数据来源都是官方的

不聚合第三方 API 站。理由很直接:常用免费 API 站里已有整站 DNS 停止解析的先例, 把站点寿命绑在别人身上不划算。每个接口都标注了上游, 查不到数据就如实报错,不返回「看起来像」的假数据。

·

为什么不返回图片

本机出口带宽 3 Mbps,一张 500KB 的图 10 个人同时要就得等 13 秒。 所以图片类接口只返回 URL,由客户端直接去取原图。 唯一的例外是二维码 —— 它由本机实时计算,几 KB,不占带宽。

·

可用性

健康检查:GET /healthz。返回 {"ok":true,"data":{"status":"up"}} 即正常。