将 Zapier 或 Make 自动化流程迁移到新的地理编码主机
基于地理编码步骤构建的无代码自动化流程,需要与自定义代码不同的迁移方法。下面介绍如何完成这种切换。
ipinfo.io 的响应风格很有特色:loc 字段将纬度和经度合并为一个以逗号分隔的字符串,而不是两个独立的数字;org 字段则将自治系统编号和组织名称捆绑在一起,形如“AS15169 Google LLC”这样的单个字符串。认证使用令牌,除此之外响应保持紧凑,基本是扁平的,在这两个合并字段之外还有 city、region、country 和 postal 等字段。
这种合并字符串格式值得特别指出,因为通过按逗号拆分来解析 loc,或通过按第一个空格拆分来解析 org 的代码,承担着实际的工作,在迁移后必须继续正确运行。这正是那种很容易被忽略的小解析细节,直到某个生产请求返回了拆分逻辑没有预料到的内容。
My Geocode 的 ipinfo 兼容主机重现了同样的紧凑结构,包括合并的 loc 字符串和以 AS 编号为前缀的 org 字符串,唯一不同的内容是版权、条款和隐私文本。参考见 /compatibility/ipinfo/。围绕拆分 loc 和 org 构建的解析逻辑应能完全照原样继续工作。
IP 查询是可以直接描述真实结果、而不只是结构的端点之一。对某个地址的查询会返回城市、地区、国家、合并的坐标字符串和合并的组织字符串,这些都是实时数据,而不是来自过时的缓存,因为 My Geocode 的 IP 地理定位数据通过一个会刷新、而不会过时的缓存层保持最新。
需要规划的迁移细节:
X-API-Key 请求头、Authorization: Bearer 请求头、HTTP Basic 认证或查询参数mg_extras=1 或 X-MG-Extras 请求头请求时,可选的附加信息(IP 威胁信号、更深入的网络详情)会与标准紧凑结构并存,不会破坏您的代码已经在读取的字段X-Quota-Used 和 X-Credits-Remaining,如果您当前的集成是手动跟踪用量的,这会很有用价格:无需密钥每天免费 2,500 次请求,每个密钥每天另外免费 2,500 次,按网络计算,之后是每次请求 €0.0001 的预付额度或每月 €50 的 Unlimited 密钥,每个端点(包括这个兼容主机)的价格都相同。对于围绕 ipinfo 特有的紧凑格式构建日志、分析或访问决策的应用来说,此次迁移的目标是格式本身永远不必改变,改变的只是提供它的服务。