免费开放 · 无需注册
权威数据,
权威数据,
一行请求就够。
数据取自中国气象局、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"}} 即正常。