新闻

与 ipstack 的兼容替换已上线

许多应用只在一个时刻使用 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-LimitX-Quota-UsedX-Quota-Free-RemainingX-Quota-Network-UsedX-Credits-Remaining 在每一次调用中都会出现。

如果您的项目需要标准响应之外的内容,在请求中加上 mg_extras=1,或发送 X-MG-Extras 请求头,即可在兼容结构之上添加可选字段,例如 IP 威胁和网络详情。它默认关闭,因此除非您明确要求,响应格式不会有任何变化。

该兼容主机的文档位于 /compatibility/ipstack/,涵盖其底层所有内容的完整 IP 查询参考位于 /docs/ipv4-lookup//docs/ipv6-lookup/