本月上线内容:地理编码、IP、时区等
API 近期工作汇总:新的兼容主机、更快的时区和海拔查询、控制台新功能,以及更清晰的配额可见性。
对于只需要快速回答一个问题的团队来说,ipinfo.io 是常见的选择:这个 IP 地址在哪里,属于哪个网络。由于这类集成通常很小,只是一个封装单次 HTTP 调用的函数,即使团队在其他方面很乐意货比三家,它也常常多年无人问津。我们的兼容主机让这种小型集成可以轻松重定向。
把原本发往 ipinfo.io 的请求改为指向我们的主机,响应会以相同的结构逐字段返回,唯一的区别是版权、条款和隐私文本,这些是我们自己的内容。如果您的代码从 JSON 正文中读取国家、地区、城市、坐标或组织信息,它会继续从相同的位置读取相同的字段。
由于 /v1/ip 能完整解析 IPv4 和 IPv6 地址,这个兼容主机同样可以。查询 8.8.8.8 这样的地址,会立即以预期的结构返回位置和网络字段,两种地址族都不需要单独配置。
身份验证方式与 My Geocode 的每个主机相同:X-API-Key 请求头、Authorization: Bearer 请求头、以密钥作为用户名的 HTTP Basic 认证,或查询参数。使用您现有 ipinfo.io 集成已经发送的那一种即可,因为这四种方式在这里同样被接受。
底层的定价结构是我们自己的,并且在平台上处处一致。任何地址无需密钥即可获得每天 2,500 次免费查询,按网络统计,因此无法把一个共享连接拆分到多个密钥上来成倍增加这项配额。密钥还会额外提供每天 2,500 次免费请求。超出之后,预付额度为每次请求 €0.0001,或者用每月 €50 的 Unlimited 套餐覆盖用量;这个主机与其他任何主机之间没有不同的费率。
每个响应都带有我们的配额响应头,提供单纯的 ipinfo.io 集成本身不会呈现的每日用量可见性:X-Quota-Limit、X-Quota-Used、X-Quota-Free-Remaining、X-Quota-Network-Used 和 X-Credits-Remaining 在每次调用中都会出现。
如果您需要标准 IP 响应之外的内容,在请求中加上 mg_extras=1 或发送 X-MG-Extras 请求头,即可在兼容结构之上叠加可选的额外信息,例如 IP 威胁和网络详情,完全由您选择。不开启它,响应就与 ipinfo.io 的格式完全一致。
该主机的文档位于 /compatibility/ipinfo/,底层 IP 查询行为的完整说明位于 /docs/ipv4-lookup/ 和 /docs/ipv6-lookup/。