本月上线内容:地理编码、IP、时区等
API 近期工作汇总:新的兼容主机、更快的时区和海拔查询、控制台新功能,以及更清晰的配额可见性。
ip-api.com 往往是开发者最先想到的 IP 地理定位服务,主要是因为它试用起来快,接入脚本也容易。我们的兼容主机正是为了保留这种简单性,同时背后采用另一套配额和定价规则。
该主机完全复刻 ip-api.com 的请求处理方式和响应正文,唯一的区别是版权、条款和隐私文本,这些是我们自己的内容。原本发往 ip-api.com 端点的请求可以改为发往我们的端点,返回的 JSON 解析方式相同,字段名称相同,位置也相同。
由于 /v1/ip 能完整解析两种地址族,这个兼容主机以相同方式处理 IPv4 和 IPv6 查询。IPv4 地址和 IPv6 地址的查询都会以正确的结构返回,无需任何额外标志来告诉主机它正在查询哪种地址。
这里的密钥身份验证方式与 My Geocode 所有其他地方相同:X-API-Key 请求头、Authorization: Bearer 请求头、以密钥作为用户名的 HTTP Basic 认证,或查询参数。您当前集成已经使用的任何方式都可以直接被接受,无需修改。
这个主机的定价与我们运行的其他所有主机和端点一致。任何地址无需密钥即可获得每天 2,500 次免费 IP 查询,按网络统计。密钥还会单独额外提供每天 2,500 次免费请求。超出之后,预付额度为每次请求 €0.0001,或者用每月 €50 的 Unlimited 套餐覆盖全部用量;使用兼容主机而非直接调用 /v1/ip 不会产生任何溢价。
这里的每个响应同样附带配额响应头,这是单纯的 ip-api.com 集成通常本身不会提供的:X-Quota-Limit、X-Quota-Used、X-Quota-Free-Remaining、X-Quota-Network-Used、X-Credits-Remaining、X-Key-IPs-Used、X-Key-IPs-Limit 和 X-Quota-Reset 全部包含在内。
对于需要比标准查询更多内容的项目,在请求中加上 mg_extras=1,或发送 X-MG-Extras 请求头,即可在兼容响应之上添加可选字段,例如 IP 威胁和网络详情;除非您主动要求,否则基础结构不会改变。
完整详情请参阅 /compatibility/ip-api/。如果您技术栈中某处的脚本已经在调用 ip-api.com,把它重定向到这里,就能快速看到一个具备配额感知、以欧元计价的主机会带来什么不同。