迁移

从 ip-api.com 迁移

ip-api.com 凭借真正简单的响应格式积累了一批用户:每次查询返回一个扁平的 JSON 对象,包含 countryregionNamecitylatlonisp 等字段,以及保存所查询 IP 地址的 query,几乎没有任何嵌套。这种扁平性使它成为任何想在项目中加入基本 IP 地理定位、又不想学习更复杂结构的人常见的首选。

IP 地理定位是可以真正展示端到端实际结果的查询之一,不像地理编码或地址自动补全那样只描述结构。对 IPv4 或 IPv6 地址发出的请求,会返回国家、地区、城市、坐标和网络信息,这些数据通过我们自己的缓存管道保持最新,而不是来自静态或更新缓慢的数据集。

My Geocode 的 ip-api 兼容主机完全重现了扁平的字段结构,包括 countryregionNamecitylatlonispquery,内容上唯一的区别是版权、条款和隐私文本。参考详情见 /compatibility/ip-api/。直接读取 response.cityresponse.isp、无需展开任何嵌套对象的代码,在更换主机和密钥后应能继续工作。

此次迁移中具体会变化的部分:

  • 认证改为使用密钥,通过 X-API-Key 请求头、Authorization: Bearer、HTTP Basic 认证或查询参数发送,而不是无需认证或仅有轻度限制的公开查询
  • 现在每个响应都通过 X-Quota-LimitX-Quota-UsedX-Quota-Reset 等响应头直接显示配额,而不必从偶尔的限流中推断
  • 可选的附加字段,包括 IP 威胁详情和更深入的网络信息,可以通过添加 mg_extras=1X-MG-Extras 请求头获得,不会改变您的代码已经在解析的扁平结构

完全不用密钥即可每天免费请求 2,500 次,每个密钥还有每天 2,500 次免费请求,按网络计算,无论是 IPv4(按 /24)还是 IPv6(按 /48),并由该网络中的无密钥使用和有密钥使用共享。超出这一额度后,是每次请求 €0.0001 的预付额度或每月 €50 的 Unlimited 密钥,每个端点(包括这个兼容主机)的价格都相同。

对于进行基于 IP 的国家重定向、欺诈信号检查或基本分析数据补充的应用来说,这通常是端到端测试起来较简单的迁移之一,因为结果是具体的,可以直接与当前集成针对同一组测试地址返回的结果进行比较。