IP地址详情v1-免费调用

IP地址详情V1接口说明IP 地理位置查询 API 是一个基于纯真 CZDB 数据库的 IP 地址定位服务。支持 IPv4 和 IPv6 地址查询可返回国家、省份、城市和运营商信息。本接口为免费接口但需要提供有效的访问密钥进行鉴权。适用于需要根据 IP 地址获取地理位置信息的各类应用场景如用户地域分析、访问日志处理、内容分发优化等。调用地址https://api.xunjinlu.fun/api/ip/cip/index.php请求方式GET密钥要求必须密钥。调用本接口时必须在请求中携带有效的访问密钥否则将返回鉴权错误。鉴权方式本接口支持以下鉴权方式Query 参数通过 URL 查询参数传递密钥计费免费分类IP工具请求参数参数名类型必填说明示例keystring是接口访问密钥开启密钥访问时必填sk_xxxxxxxxxxxxxxxxipstring否要查询的 IP 地址IPv4 或 IPv6不传则自动获取客户端 IP8.8.8.8参数说明key您的接口访问密钥用于身份鉴权和配额管理。密钥可在平台控制台申请和管理。ip需要查询地理位置的 IP 地址。支持 IPv4 和 IPv6 格式。如果不传递此参数系统将自动使用发起请求的客户端 IP 地址进行查询。典型取值示例场景keyip说明查询指定 IPv4sk_xxxxxxxxxxxxxxxx8.8.8.8查询 Google DNS 的地理位置查询指定 IPv6sk_xxxxxxxxxxxxxxxx2001:4860:4860::8888查询 IPv6 地址的地理位置查询当前客户端 IPsk_xxxxxxxxxxxxxxxx不传自动获取请求方 IP 并返回其地理位置请求示例使用 Query 参数鉴权GET https://api.xunjinlu.fun/api/ip/cip/index.php?keysk_xxxxxxxxxxxxxxxxip8.8.8.8PHP 示例// IP地址详情查询示例 $key sk_xxxxxxxxxxxxxxxx; $ip 8.8.8.8; $url https://api.xunjinlu.fun/api/ip/cip/index.php?key{$key}ip{$ip}; $ch curl_init(); curl_setopt($ch, CURLOPT_URL, $url); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); $response curl_exec($ch); curl_close($ch); $result json_decode($response, true); if ($result[code] 200) { echo IP: . $result[data][ip] . ; echo 国家: . $result[data][country] . ; echo 省份: . $result[data][province] . ; echo 城市: . $result[data][city] . ; echo 运营商: . $result[data][isp] . ; } else { echo 错误: . $result[msg] . ; }成功响应示例{ code: 200, msg: 查询成功, data: { ip: 8.8.8.8, version: IPv4, country: 美国, province: 加利福尼亚州, city: 山景城, district: , isp: Google DNS, raw: 美国–加利福尼亚州–山景城– Google DNS, query_time: 2026-05-12 22:45:30 }, api_info: { developer: 尋鯨錄, blog: https://www.xunjinlu.fun, api_platform: https://api.xunjinlu.fun } }响应字段说明顶层字段字段名类型说明codeinteger状态码200 表示成功msgstring响应消息dataobject查询结果数据api_infoobjectAPI 平台信息data 对象字段字段名类型说明ipstring查询的 IP 地址versionstringIP 版本IPv4 或 IPv6countrystring国家provincestring省份/州citystring城市districtstring区县ispstring运营商rawstring原始地理位置信息完整拼接字符串query_timestring查询时间格式YYYY-MM-DD HH:MM:SSapi_info 对象字段字段名类型说明developerstring开发者名称blogstring开发者博客地址api_platformstringAPI 平台地址错误响应示例当请求出现错误时接口返回如下格式的 JSON{ code: 0, msg: 未提供调用密钥, errcode: 11001 }业务错误码说明错误码处理建议错误码建议处理方式11001检查请求中是否携带了 key 参数11002确认密钥是否正确注意区分大小写11003联系平台客服确认密钥状态11004充值积分或等待积分恢复11005降低请求频率遵守 QPM 限制11006等待接口维护完成后重试11007联系平台客服确认接口状态11008稍后重试或联系平台客服11009稍后重试密钥校验11010稍后重试11011确认接口是否为收费接口并提供有效密钥11012检查鉴权方式是否正确本接口支持 Query 参数方式11013确认调用地址是否正确11014检查请求参数是否合法11015确认请求地址是否在允许列表中11016稍后重试或联系平台客服11017稍后重试11018确认请求方式是否正确本接口仅支持 GET注意事项密钥安全请妥善保管您的访问密钥避免泄露。建议不要在客户端代码中硬编码密钥。IP 格式传入的 IP 地址需为合法的 IPv4 或 IPv6 格式否则可能返回查询失败。自动获取 IP当不传递 ip 参数时系统将自动使用 HTTP 请求的源 IP 地址进行查询。数据更新IP 地理位置数据基于纯真 CZDB 数据库数据更新频率以数据库发布周期为准。请求频率虽然本接口免费但仍受平台整体请求频率限制请合理控制调用频率。