ICP备案信息查询是网站运营中的重要环节,接口盒子提供的免费API接口可以帮助开发者快速获取域名备案信息。本文将详细介绍该接口的使用方法,并提供PHP和Python调用示例。
接口基本信息
- 请求地址:
https://cn.apihz.cn/api/wangzhan/icp.php
- 请求方式: GET或POST
- 请求参数:
参数名 | 必填 | 说明 |
id | 是 | 用户中心的数字ID |
key | 是 | 用户中心通讯秘钥 |
domain | 是 | 要查询的域名 |
type | 否 | 查询通道(1或2),默认随机 |
- 返回参数:
参数名 | 说明 |
code | 状态码(200成功/400错误) |
msg | 错误提示信息 |
icp | 备案号 |
unit | 备案主体 |
domain | 备案域名 |
time | 审核时间 |
调用注意事项
- 使用自己的ID和KEY(注册获取)
- 公共ID(
88888888
)有频次限制 - 查询失败时可切换
type
通道重试 - 每日调用无上限
调用示例
1. GET方式调用
直接在URL中拼接参数:
bash
复制
https://cn.apihz.cn/api/wangzhan/icp.php?id=您的ID&key=您的KEY&domain=apihz.cn
2. PHP调用示例
php
复制
<?php $api_url = 'https://cn.apihz.cn/api/wangzhan/icp.php'; $params = [ 'id' => '您的ID', // 替换为实际ID 'key' => '您的KEY', // 替换为实际KEY 'domain' => 'apihz.cn' ]; // 拼接GET请求URL $request_url = $api_url . '?' . http_build_query($params); // 发送请求 $response = file_get_contents($request_url); // 解析结果 $result = json_decode($response, true); if ($result['code'] == 200) { echo "备案号: " . $result['icp'] . "\n"; echo "主体: " . $result['unit'] . "\n"; echo "域名: " . $result['domain'] . "\n"; echo "审核时间: " . $result['time']; } else { echo "查询失败: " . $result['msg']; } ?>
3. Python调用示例
python
运行
复制
import requests def query_icp(domain, user_id, user_key): url = "https://cn.apihz.cn/api/wangzhan/icp.php" params = { 'id': user_id, 'key': user_key, 'domain': domain } try: response = requests.get(url, params=params) data = response.json() if data['code'] == 200: print(f"备案号: {data['icp']}") print(f"主体: {data['unit']}") print(f"域名: {data['domain']}") print(f"审核时间: {data['time']}") else: print(f"查询失败: {data['msg']}") except Exception as e: print(f"请求异常: {str(e)}") # 使用示例 query_icp( domain="apihz.cn", user_id="您的ID", # 替换为实际ID user_key="您的KEY" # 替换为实际KEY )
返回结果示例
成功响应:
json
复制
{ "code": 200, "icp": "蜀ICP备2020030589号-1", "unit": "绵阳耳关明皿网络科技有限公司", "domain": "erguanmingmin.com", "time": "2021-12-20" }
错误响应:
json
复制
{ "code": 400, "msg": "通讯秘钥错误。" }
常见问题处理
- KEY验证失败:检查用户中心生成的KEY是否复制完整
- 无返回结果:尝试指定
type=1
或type=2
切换查询通道 - 频繁超时:公共KEY有并发限制,建议注册独立账号
官方文档参考:ICP备案查询API文档