当前位置:浏览接口 > IP查询

IP查询

官方提供

描述:根据IP或域名返回IP所属区域和运营商

  • 数据ID:8
  • 接口状态:正常
  • 付费类型:收费
  • 免费次数:500
  • 所属分类:站长工具
  • 上架时间:2018-04-27
申请数据费用: 0.001/次(VIP等级越高、费用越低)

步骤一:批量提交查询请求,并获得提取任务ID

接口地址:http://apidata.chinaz.com/BatchAPI/IP

返回格式:JSON

请求方式:POST

请求参数:

名称 类型 必填 说明
key string 申请接口时获取的key
ips string 获取的ip或域名,多个用“|”隔开
如:127.0.0.1|128.1.1.1|chinaz.com
(每个IP算一次查询,最高支持50个)

返回参数说明:

名称 类型 说明
StateCode int 状态
Reason string 状态说明
TaskID string 成功返回的任务ID
Total int 成功提交总条数

JSON返回示例:

{
    "StateCode": 1,
    "Reason": "提交成功",
    "TaskID": "a05e12b7d148407d8bbf0fb9",
    "Total": 2
} 

步骤二:根据提取任务ID查询数据是否采集完成,如果完成则得到Json格式结果

接口地址:http://apidata.chinaz.com/batchapi/GetApiData

返回格式:JSON

请求方式:POST

请求参数:

名称 类型 必填 说明
taskid string 步骤一返回的任务ID

返回参数说明:

名称 类型 说明
StateCodeint状态码
Reasonstring状态说明
TaskIDstring任务ID
SubmitTimestring提交时间
FinishedTimestring成功时间
SubmitCountint成功提交条数
SuccessCountint成功抓取条数
IPstringip
Citystring所在的城市
Countrystring所在国家
Districtstring所在的地区
Ispstring运营商
Provincestring所在省份、州

JSON返回示例:

{
    "StateCode": 1,
    "Reason": "成功",
    "Result": {
        "TaskID": "a05e12b7d148407d8bbf0fb9",
        "SubmitTime": "20190125103354",
        "FinishedTime": "20190125103356",
        "SubmitCount": 2,
        "SuccessCount": 2,
        "Data": [
            {
                "IP": "127.0.0.1",
                "City": null,
                "Country": "本机地址",
                "District": null,
                "Isp": "",
                "Province": null
            },
            {
                "IP": "128.1.1.1",
                "City": "洛杉矶",
                "Country": "美国",
                "District": null,
                "Isp": "zenlayer.com",
                "Province": "加利福尼亚州"
            }
        ]
    }
}
API测试工具
我的数据:
IP查询
APPKEY:qaz1wsx2edc3rfv4tgb5yhn6ujm7ik8ol9p0

接口列表:
获取方式:
返回格式:
API参数:

注:此测试只适用于“单一调用”接口测试,
“批量调用”测试请看详细文档说明。

   点击左侧调用接口按钮可自动生成相关代码
返回的内容:复制全部代码
错误代码说明
1成功
0获取数据状态信息
-1系统异常
1001请输入正确的IP地址
10001错误的请求KEY
10002该KEY无请求权限
10003KEY过期
10004错误的SDK KEY
10005应用未审核,请提交认证
10007未知的请求源,(服务器没有获取到IP地址)
10008被禁止的IP
10009被禁止的KEY
10011当前IP请求超过限制
10012当前Key请求超过限制
10013测试KEY超过请求限制
10020接口维护
10021接口停用
10022appKey剩余请求次数不足
10023请求IP无效
10024网络错误
10025没有查询到结果
10026当前请求频率过高超过权限限制
10027账号违规被冻结
10028传递参数错误
10029系统内部异常,请重试
10030校验值sign错误
10031套餐产品编号不存在
10032虚拟账号余额不足
10033提交的订单号不能重复
10034通道请求超时
内容说明
客服QQ1751691323