ip-api.com 兼容替换
ip-api 的 JSON 端点是被模仿最广泛的 IP 查询格式之一。ipapi.mygeocode.com 对 IPv4 和 IPv6 地址返回相同的字段名,而且免费密钥也支持 HTTPS,这是 ip-api 所不提供的。
只需更换一个主机名
| 原始主机 |
|
|---|---|
| 改用 | ipapi.mygeocode.com |
| 密钥参数 | key(可选:任何地址不使用密钥每天也有 2,500 次请求;如需使用额度、套餐和使用记录,请在此填入您的 My Geocode 密钥) |
之前
curl "http://ip-api.com/json/8.8.8.8?fields=status,country,countryCode,city,lat,lon,timezone,isp,query"之后
curl "https://ipapi.mygeocode.com/json/8.8.8.8?fields=status,country,countryCode,city,lat,lon,timezone,isp,query"端点
响应示例
这是上述请求返回的内容。字段名、嵌套和类型与 ip-api 一致。只有背后的数据来自我们。
来自 ipapi.mygeocode.com 的响应
{
"status": "success",
"country": "United States",
"countryCode": "US",
"region": "CA",
"regionName": "California",
"city": "Mountain View",
"zip": "94043",
"lat": 37.4056,
"lon": -122.0775,
"timezone": "America/Los_Angeles",
"isp": "Google LLC",
"org": "Google Public DNS",
"as": "AS15169 Google LLC",
"query": "8.8.8.8"
}细节与差异
每天前 2,500 次请求无需密钥。如需使用 My Geocode 密钥,请将其放在原来 ip-api.com 密钥的位置:key 查询参数。X-API-Key 请求头、Authorization: Bearer 和 HTTP Basic 认证(以密钥作为用户名)也适用于每个主机,因此以自有方式进行认证的客户端库无需任何修改即可继续工作。
响应只包含 ip-api.com 返回的字段,别无其他,因此可以直接用于已经在解析 ip-api.com 的代码。我们的附加数据(地面海拔、威胁和网络详情)可按需获取:在查询中添加 mg_extras=1 或发送 X-MG-Extras: 1。
- 默认响应是 ip-api 自己的字段集,并保持其顺序。
fields接受字段名或数字位掩码,lang可将国家和大洲名称翻译为 de、es、pt-BR、fr、ja、zh-CN 和 ru。 json、xml、csv和line格式都可以使用。- 与 ip-api 一样,无效地址返回 HTTP 200 和
status: fail;只有密钥和配额被拒绝时才会改变状态码。 - 与 ip-api 一样,批量端点最多接受 100 个条目,每个条目可单独设置
fields和lang;其中每个地址计为一个请求。 - 请求
reverse即可解析该地址的主机名。 - 美国、加拿大和澳大利亚的地区名称以简短代码返回;其他地方的数据集只有全称。
如果您的客户端依赖于此处未列出的字段或行为,请告诉我们。兼容性缺口通常很小,因此会很快修复。