本月上线内容:地理编码、IP、时区等
API 近期工作汇总:新的兼容主机、更快的时区和海拔查询、控制台新功能,以及更清晰的配额可见性。
许多应用只在一个时刻使用 IP 地理定位:用户首次连接时,用来猜测国家或设置默认货币,然后就不再理会。长期以来,ipstack 一直是这一步的常见选择。我们新的兼容主机让这一步继续以同样的方式工作,只是背后换成了另一个后端。
该主机精确复刻 ipstack 的请求参数和响应正文,唯一的区别是版权、条款和隐私文本,这些内容对应的是 My Geocode 而非原提供商。您的应用目前在哪里发送按 ipstack 格式构建的查询,就可以把同样的查询发送到我们的主机,返回的字段会落在您现有解析代码期望的相同位置。
这里完整支持两种地址族,与 /v1/ip 在平台其他地方的工作方式一致。IPv4 地址和 IPv6 地址都能在这个主机上正确解析,两者的响应结构相同。
密钥可以通过 X-API-Key 请求头、Authorization: Bearer 请求头、以密钥作为用户名的 HTTP Basic 认证或查询参数传递,与您现有 ipstack 集成已经使用的方式保持一致。这四种方式在我们运行的每个主机和端点上都被同等接受,因此身份验证代码通常无需修改。
这个主机背后的定价与其他地方相同。任何地址无需密钥即可获得每天 2,500 次免费查询,按网络统计,因此一间共享的办公室或一栋楼共用一个额度池,而不是多个。密钥本身还会额外提供每天 2,500 次免费请求。超出这些配额后,预付额度为每次请求 €0.0001,或者用每月 €50 的 Unlimited 套餐覆盖;这个兼容主机没有单独的费率。
每个响应也都包含我们完整的配额响应头集合,这是单纯的 ipstack 集成本身不会提供的:X-Quota-Limit、X-Quota-Used、X-Quota-Free-Remaining、X-Quota-Network-Used 和 X-Credits-Remaining 在每一次调用中都会出现。
如果您的项目需要标准响应之外的内容,在请求中加上 mg_extras=1,或发送 X-MG-Extras 请求头,即可在兼容结构之上添加可选字段,例如 IP 威胁和网络详情。它默认关闭,因此除非您明确要求,响应格式不会有任何变化。
该兼容主机的文档位于 /compatibility/ipstack/,涵盖其底层所有内容的完整 IP 查询参考位于 /docs/ipv4-lookup/ 和 /docs/ipv6-lookup/。