本月上线内容:地理编码、IP、时区等
API 近期工作汇总:新的兼容主机、更快的时区和海拔查询、控制台新功能,以及更清晰的配额可见性。
对于一个 IP 地址来说,位置往往只是重要信息的一部分。该地址是否与已知的威胁活动有关,以及它实际属于哪种网络,对于欺诈防范、访问控制或一般风险评估而言可能同样重要。/v1/ip 现在将这些信息作为可选的附加内容返回,只要您请求即可获得。
在请求中添加 mg_extras=1,或发送 X-MG-Extras 请求头,即可在标准位置响应之上叠加 IP 威胁和网络详情,而已返回的基础字段不会有任何变化。不加这个标志,响应和以前完全一样。加上它,同一个调用会在您已经收到的位置字段之外返回额外的详情。
同样的机制也适用于地面海拔,因此 mg_extras=1 是在不同端点上请求更多信息的单一、一致的方式,而不是每个功能各用一个单独的标志。它同样适用于我们的兼容主机,因此按 ip-api.com、ipinfo.io 或 ipstack 格式构造的请求,可以在其原本完全匹配的请求和响应格式之上添加同样的标志或请求头,在获得威胁和网络详情的同时,不破坏与原始格式的兼容性。
是否请求附加信息不会影响价格。添加了 mg_extras=1 的查询,与不带它的查询一样,都按一次请求计入您的免费额度、预付额度或 Unlimited 套餐。附加详情没有单独的、更贵的档位,也没有需要专门为附加信息跟踪的单独配额。
这项功能面向的正是仅靠位置信息不够的用例。筛查注册中可疑活动的应用、决定是否对某个连接进行额外验证的服务,或构建更全面网络信誉画像的安全工具,都可以直接从它们已经在进行的同一个 /v1/ip 调用中获取这些背景信息,而不必仅仅为了这一项信息,再维护与另一个威胁情报提供商的第二套集成。
IP 端点的完整文档,包括如何添加附加信息,请参见 /docs/ipv4-lookup/ 和 /docs/ipv6-lookup/。由于它完全是可选启用的,在现有集成上测试它,只需在您已有的调用中添加一个标志即可。