API 概述
该API接口提供襄阳防火墙域名白名单管理功能,允许用户将指定域名添加到白名单中,以便正常访问域名。
接口支持两种请求方式(GET和POST),并返回JSON格式的响应数据,包含操作结果状态码和相关信息。
实时处理
安全认证
跨域支持
接口详情
GET/POST
请求参数
参数名 | 类型 | 是否必需 | 说明 |
---|---|---|---|
ip
|
字符串 | 必需 | 服务器IP地址(必须是七星云襄阳服务器IP) |
domain
|
字符串 | 必需 | 需要过白的域名 |
响应示例
成功响应
{ "code": 0, "msg": "域名过白成功", "original_domain": "qq.com", "wildcard_domain": ".qq.com" }
失败响应
{ "code": 301, "msg": "该服务器IP不是我们的IP,无法过白", "original_domain": "qq.com", "wildcard_domain": ".qq.com" }
使用示例
PHP 示例代码
<?php // 服务器IP和域名 $serverIp = "过白的服务器IP"; $domain = "qq.com"; // 构建API请求URL $apiUrl = "https://gb.qixidc.cn/xy/api.php?api=1&ip=" . urlencode($serverIp) . "&domain=" . urlencode($domain); // 发送请求 $response = file_get_contents($apiUrl); $result = json_decode($response, true); // 处理响应 if ($result && $result['code'] == 0) { echo "成功: " . $result['msg']; echo "原始域名: " . $result['original_domain']; echo "通配符域名: " . $result['wildcard_domain']; } else { echo "错误: " . ($result['msg'] ?? '未知错误'); } ?>
错误代码说明
0 - 成功
域名过白成功
301 - 服务器IP不在白名单
该服务器IP不是襄阳服务器IP,无法过白
-1 - 添加白名单失败
添加白名单过程中出现错误
401 - 缺少参数
请求中缺少必需的参数
402 - IP格式无效
提供的IP地址格式不正确
403 - 提交限制
每个IP每日最多提交30个域名
404 - IP被禁止
IP已被禁止提交
405 - 域名已过白
该域名已在襄阳地区过白,无需重复提交
500 - 服务器内部错误
服务器处理请求时发生错误
复制成功