### 域名备案快速查询api文档
**#### 与上一章节的备案查询服务接口的差别:**
本接口为备案查询接口,简化了备案详情,用于快速判断域名是否备案的场景,接口响应时间将获得大幅度提升。如果域名已备案则只返回是否备案以及具体的ICP备案号。
**接口调用范例地址 (GET方式)**
> 接口请求地址:http://s.hescloud.cn/api/icp?token=您的令牌&url=域名
> 本接口提供测试token令牌,但会根据实际并发情况限制调用频率(20s-60s之间):testicp
token为令牌
url只需传入域名即可,不能携带协议头或者符号,否则将被系统拒绝请求.
测试调用:[http://s.hescloud.cn/api/icp?token=testicp&url=tengmiwang.cn](http://s.hescloud.cn/api/icp?token=testicp&url=您的域名)
**#### 接口返回json格式:**
~~~
{
"code": 0,
"url": "tengmiwang.cn",
"data": null,
"msg": "未备案"
}
~~~
~~~
{
"code": 1,
"url": "tengmiwang.com",
"data": "冀ICP备20001045号",
"msg": "已备案"
}
~~~
~~~
{"code":-103,"url":"","data":null,"msg":"token参数不得为空"}
~~~
~~~
{"code":-105,"url":"hestia.me","data":null,"msg":"请求频率太快"}
~~~
~~~
{"code":-104,"url":"","data":null,"msg":"待检测的域名格式错误"}
~~~
以上仅列举部分返回结果示例,具体所有返回结果编码对照表如下:
| 编码(code) | 释义(msg) |
| --- | --- |
| 1 | 查询成功,域名已备案 |
| 0 | 查询成功,域名未备案 |
| -2 | token不存在或者已过期 |
| -101 | token和url参数不得为空 |
| -102 | url参数不得为空 |
| -103 | token参数不得为空 |
| -104 | 待检测的域名格式错误 |
| -105 | 请求频率太快 |
| -106 | 域名备案查询接口已过期 |
| -107 | 域名备案查询接口存在违规情况,具体原因请联系客服! |
| -110 | 查询异常,请重试或者联系客服! |
如果您获取到的code为1,则代表查询的域名状态为备案,则返回结果json对象里的data字段将有详细参数,其结果为ICP备案编号;如果获取到的结果为0,则data字段为null或其他不重要参数。
注:飞鸟域名备案查询接口数据100%来源于工信部网站数据最新数据,非缓存数据,数据准确可靠。系统采用业内最新进技术,支持高并发,接口查询准确,响应速度毫秒级。目前已开放无限次调用和分频率调用相关版本,有需要的用户可联系我站客服(百度搜索wxoauth)了解详情。
本文档将不定期更新,敬请保持关注!
--wxoauth团队
[官网链接点击直达](http://www.wxoauth.cn)