开发者需调用IP查询API获取地理位置等信息，含无需认证的公共接口、商用免费API、微信官方IP列表、需密钥的身份验证服务及批量查询脚本五类方案。
如果您需要在应用中集成IP地址查询功能，以获取用户地理位置、网络归属或安全风控所需信息，则需调用标准化的IP查询地址API接口。以下是面向开发者的完整调用指南：
一、使用无需认证的公共IP查询接口
此类接口适用于快速验证、原型开发或低频调用场景，无需注册、不需密钥，直接发起HTTP请求即可获得基础IP信息。
1、访问 https://api.ipify.org 获取纯文本格式的本机公网IPv4地址。
2、访问 https://api.ipify.org?format=json 获取包含IP字段的JSON响应。
3、调用 https://ipapi.co/json/ 获取当前出口IP的国家、城市、时区、ISP等结构化地理信息。
4、向 http://opendata.baidu.com/api.php?apiquery=123.123.123.123&resource_id=6006&oe=utf8 发送GET请求，解析返回的UTF-8编码JSON，提取guo（国家）、sheng（省份）、shi（城市）字段。
二、调用带地理定位能力的商用免费API
该类接口在返回IP地址基础上，额外提供精确到区县的地理位置、经纬度、运营商及ASN编号，适合内容本地化与风控系统集成。
1、向 https://cn.apihz.cn/api/ip/chaapi.php?id=YOUR_ID&key=YOUR_KEY&ip=115.192.236.48 发起GET请求，其中id与key需替换为接口盒子平台分配的专属凭证。
2、设置参数 td=1 指定使用通道1进行查询，提升对国内中小运营商IP的识别准确率。
3、若未传入ip参数，接口将自动识别请求来源IP并返回其归属地，适用于用户无感定位场景。
4、检查返回JSON中的 code 字段：值为200表示成功，400表示参数错误或密钥无效，需校验id与key格式是否正确。
三、通过微信官方接口获取回调服务器IP列表
当开发者需配置防火墙白名单或构建可信通信链路时，必须动态获取微信推送服务的真实出口IP，避免硬编码导致服务中断。
1、使用已获取的有效 access_token，构造请求URL：https://api.weixin.qq.com/cgi-bin/getcallbackip?access_token=ACCESS_TOKEN。
2、发起HTTPS GET请求，接收返回的JSON数据，确认 ip_list 字段为非空数组。
3、将响应中全部IP地址写入本地缓存，并设置有效期为24小时，确保每日至少刷新一次IP列表。
4、禁止将单个IP作为唯一入口，应将整个 ip_list 数组纳入负载均衡或容灾路由策略。
四、集成需API密钥的身份验证型服务
适用于生产环境高频调用场景，提供稳定QPS保障、完整IP画像及异常行为标记能力，需完成账号注册与权限配置。
1、前往IP数据云控制台注册账号，获取 API_URL、API_KEY 及请求方式说明。
2、构造请求参数：在URL中添加 ip=8.8.8.8 与 key=YOUR_API_KEY，确保参数顺序不影响签名验证。
3、在HTTP请求头中添加 Authorization: APPCODE YOUR_APPCODE（如阿里云市场接口）或按服务商要求放置密钥。
4、捕获 429 Too Many Requests 响应状态码，触发退避重试机制，间隔时间不少于1秒。
五、批量查询多个IP地址的自动化脚本方案
针对日志分析、黑产识别或合规审计等需处理海量IP的业务，应避免人工逐条调用，转而采用结构化批处理流程。
1、准备纯文本IP列表文件，每行一个IPv4地址，保存为 ips.txt。
2、使用Python的requests库编写循环脚本，每次请求前加入 time.sleep(0.5) 防止触发频率限制。
3、将每次响应结果中的 country、isp、network_type 字段提取后写入CSV文件。
4、对返回code不为200的IP记录单独归档，生成 failed_ips.log 供人工复核。
