襄阳防火墙域名白名单管理 API

简单高效的接口,用于将域名添加到防火墙白名单中,支持GET和POST请求方式

查看接口文档

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 - 服务器内部错误
服务器处理请求时发生错误
复制成功