接入

中国实时数据 API 横向实测(2026-11-20)

不看宣传页上的"毫秒级响应",直接在同一台服务器上把每个源打 5 次,记状态码和耗时。这台机器是本站生产环境(阿里云 ECS,张家口节点,2 核 3G),跑的就是线上同一套代码路径。

测试时间:2026-11-20 下午(北京时间)· 每个源 5 次 · curl -m 12 · 未走缓存

一、原始结果:各公开源单独测

数据源 用途 5 次结果 耗时区间 判断
api.open-meteo.com天气5/5 2000.93 – 3.73 s可用,但偏慢,必须缓存
whois.pconline.com.cnIP(国内)4/5 200,1 次 5030.14 – 0.75 s国内 IP 首选,偶发限流
ipinfo.ioIP(境外)5/5 2000.54 – 0.67 s境外首选,最稳
api.ip.sbIP(兜底)5/5 2000.43 – 2.57 s兜底可用
ip-api.com(https)IP0/5,全部 12 s 超时—免费版不支持 https,弃用
ip-api.com(http)IP3/5 200,2 次超时1.34 – 6.40 s不稳,不做主源
ipapi.coIP0/5,全部 429—免费额度耗尽,移除
weibo.com 热榜接口热搜无 UA 时 5/5 4030.05 s必须带 UA 与 Referer
top.baidu.com热搜5/5 2000.07 – 0.08 s又快又稳

"5 次结果"指 HTTP 状态码统计;超时按 curl 的 -m 12 记为失败。

二、经过适配器之后的表现

上表是单个源裸测。实际服务里是"主源失败自动切备源",所以看最终对外表现更准确。下面这组绕过缓存、每项 8 次:

接口 成功率 中位耗时 最大耗时
weather(洛阳 / 3 天)8/8303.6 ms2175.3 ms
ip(8.8.8.8)8/8260.6 ms1466.3 ms
hot(微博)8/838.2 ms56.5 ms
hot(百度)8/823.6 ms56.2 ms

ip 这一行是最好的证明:单源裸测时 ip-api 有 12 秒超时,改成分层选源后中位降到 260 毫秒、最大 1.47 秒,8 次全成。

三、从这些数字里做了三个决定

1. IP 归属地按"国内 / 境外"分层选源。pconline 查国内 IP 只要 0.14–0.75 秒,但查 8.8.8.8 会直接返回 noprovince;ipinfo.io 反过来对境外地址最稳(0.54–0.67 秒,5/5 成功)。所以顺序是 pconline → ipinfo.io → ip.sb,国内 IP 命中第一个,境外 IP 快速失败后落到第二个,两条路都短。ipapi.co 已经 429 全灭,直接删掉。

2. 给每个单源加超时,不让慢源拖住整次调用。不设上限时,一次请求可能被某个境外源拖到 12 秒以上。现在天气 10 秒、IP 与热搜 6 秒,超时立即切下一个源,并由熔断器记账——连续失败三次就冷却 60 秒,探测成功再放回来。

3. 缓存 + 落盘 + 过期兜底,三者缺一不可。天气慢(0.9–3.7 秒),靠 15 分钟缓存把绝大多数请求挡在上游之外;缓存同时写入本地 SQLite,进程重启后仍在;上游全挂时返回最近一份数据并在 _cache.stale 里标明年龄,而不是报错或冒充新数据。

四、怎么自己复现

在任意一台国内机器上执行,逐源 5 次看状态码与耗时:

for u in \
  "https://api.open-meteo.com/v1/forecast?latitude=34.62&longitude=112.45&current=temperature_2m" \
  "https://whois.pconline.com.cn/ipJson.jsp?ip=114.114.114.114&json=true" \
  "https://ipinfo.io/8.8.8.8/json" \
  "https://api.ip.sb/geoip/8.8.8.8" \
  "https://ip-api.com/json/8.8.8.8" \
  "https://top.baidu.com/api/board?platform=wise&tab=realtime"; do
  echo "--- $u"
  for i in 1 2 3 4 5; do
    curl -s -o /dev/null -m 12 -w '%{http_code} %{time_total}s\n' "$u"
  done
done

注意两点:ip-api 的 https 一定失败(免费版限制);微博热榜不带 UA 与 Referer 会返回 403,不是接口坏了。

五、这些数字说明的边界

  • 以上都是免费公开源,稳定性和 SLA 不能与付费源相比。天气源最慢能到 2–3 秒,这是上游本身的耗时,不是本服务的问题,只能靠缓存摊薄。
  • 免费额度随时会收紧(ipapi.co 就是例子:前一天还能用,第二天全 429)。本站的做法是把源列表做成配置,换源不改编代码。
  • 商用需要授权。Open-Meteo 与 ipinfo 免费版条款都限制商业用途,热搜是公开榜单抓取。正式商用前请替换为已授权源。
  • 测试只有 5–8 次采样,且全部来自同一台机器同一个出口。换个地域或运营商,结果会变,尤其是 pconline 的 503 频率。

继续看:实时数据层总览 · 接口文档(参数与错误码) · 完整 API 文档 · 额度与积分