白名单接口

1. 添加白名单接口列表

白名单可以添加IP，IPc段，IP属性，城市，国家，指纹。添加成功后不需要验证可以直接通过。

1.1 添加白名单

接口地址： https://tj.wuthreat.com/tj/next_captcha/api_control/put_white

请求方法： post/get

请求类型： multipart/form-data

请求参数：

参数名 类型 必填 示例值 参数说明
AppKey String 是 01HQ********RLO9 无胁安全平台创建验证码后得到的AppKey
AppToken String 是 10t5********ntz3 无胁安全平台创建验证码后得到的AppToken
WhiteType Number 是 1 类型(1:IP，2:IP属性，3:城市，4:国家，5:指纹)
Value String 是 8.8.8.8 值(IP(IP段最大支持c段)，IP属性(IDC，基站)，城市，国家，指纹) *注：类型必须与值对应。。例：WhiteType=1&Value=127.0.0.1，WhiteType=3&Value=北京市
Delete String 是 Y 强制删除(Y或N)。Y：添加IP段时，如果和已添加的IP或IP段有冲突直接删除已添加的IP或IP段；N：添加IP段时，如果和已添加的IP或IP段有冲突返回冲突IP或IP段的信息

返回参数说明：

参数名 类型 示例值 参数说明
code Number 1 响应码
message String success 响应信息

返回示例：

  • 正常返回：

    例：{
            "code": 1,
            "message": "success"
        }
1.2 响应码解析

响应码列表

返回码 说明
1 添加白名单成功
1102 参数名错误
1103 参数类型错误
1105 值重复
1143 删除已有的IP或IP段失败
1155 值格式错误（IP段最大支持c段）
1164 白名单条数超出限制
1165 AppKey或AppToken错误
1166 类型格式错误
1172 二维码策略不能添加黑白名单
1185 白名单已有此IP，请勿重复添加
1186 返回的IP或IP段与添加IP有冲突
1187 强制删除参数错误
1188 您的IP不在平台白名单中,请添加IP到平台白名单
1.3 示例代码

1.3.1 Python


    import requests
    data = {
        'AppKey': '01HQ********RLO9',
        'AppToken': '10t5********ntz3',
        'WhiteType': 1,
        'Value': '6.6.6.6',
        'Delete': 'Y'
    }
    
    response =  requests.post('https://tj.wuthreat.com/tj/next_captcha/api_control/put_white', data=data)

1.3.2 Java


    
    Request request = Request.Post("https://tj.wuthreat.com/tj/next_captcha/api_control/put_white");
    String body = "AppKey=01HQ********RLO9&AppToken=10t5********ntz3&WhiteType=1&Value=8.8.8.8&Delete=Y";
    request.bodyString(body,ContentType.APPLICATION_FORM_URLENCODED); request.setHeader("Content-Type", "application/x-www-form-urlencoded"); 
    HttpResponse httpResponse = request.execute().returnResponse(); System.out.println(httpResponse.getStatusLine());
    if (httpResponse.getEntity() != null) { 
            String html = EntityUtils.toString(httpResponse.getEntity()); 
            System.out.println(html);
    }
2. 获取白名单接口列表

获取单个类型的白名单列表，可以直观的看到已经添加的白名单。

2.1 获取白名单

接口地址： https://tj.wuthreat.com/tj/next_captcha/api_control/get_white

请求方法： post/get

请求类型： multipart/form-data

请求参数：

参数名 类型 必填 示例值 参数说明
AppKey String 是 01HQ********RLO9 无胁安全平台创建验证码后得到的AppKey
AppToken String 是 10t5********ntz3 无胁安全平台创建验证码后得到的AppToken
WhiteType Number 是 1 类型(1:IP，2:IP属性，3:城市，4:国家，5:指纹)。 例：WhiteType=1代表查询

返回参数说明：

参数名 类型 示例值 参数说明
code Number 1 响应码
data Array ["8.8.8.8",......] 返回数据
message String success 响应信息

返回示例：

  • 正常返回：

    例：{
        
            "code": 1,
            "data": [
                "8.8.8.8"
            ],
            "message": "success"
        }
2.2 响应码解析

响应码列表

返回码 说明
1 添加白名单成功
1102 参数名错误
1103 参数类型错误
1165 AppKey或AppToken错误
1166 类型格式错误
1188 您的IP不在平台白名单中,请添加IP到平台白名单
2.3 示例代码

2.3.1 Python


    import requests
    data = {
        'AppKey': '01HQ********RLO9',
        'AppToken': '10t5********ntz3',
        'WhiteType': 1
    }
    
    response = requests.post('https://tj.wuthreat.com/tj/next_captcha/api_control/get_white', data=data)

2.3.2 Java


        Request request = Request.Post("https://tj.wuthreat.com/tj/next_captcha/api_control/get_white"); 
        String body =
        "AppKey=01HQ********RLO9&AppToken=10t5********ntz3&WhiteType=1"; request.bodyString(body,ContentType.APPLICATION_FORM_URLENCODED); request.setHeader("Content-Type", "application/x-www-form-urlencoded"); 
        HttpResponse httpResponse = request.execute().returnResponse(); System.out.println(httpResponse.getStatusLine()); 
        if (httpResponse.getEntity() != null) { 
                String html = EntityUtils.toString(httpResponse.getEntity()); 
                System.out.println(html); 
        }
3. 删除白名单接口列表

删除白名单后，需要验证才可以通过。

3.1 删除白名单

接口地址： https://tj.wuthreat.com/tj/next_captcha/api_control/del_white

请求方法： post/get

请求类型： multipart/form-data

请求参数：

参数名 类型 必填 示例值 参数说明
AppKey String 是 01HQ********RLO9 无胁安全平台创建验证码后得到的AppKey
AppToken String 是 10t5********ntz3 无胁安全平台创建验证码后得到的AppToken
WhiteType Number 是 1 类型(1:IP，2:IP属性，3:城市，4:国家，5:指纹)
Value String 是 8.8.8.8 值(IP(IP段最大支持c段)，IP属性(IDC，基站)，城市，国家，指纹) *注：类型必须与值对应，否则会显示删除失败。例：WhiteType=1&Value=127.0.0.1，WhiteType=3&Value=北京市

返回参数说明：

参数名 类型 示例值 参数说明
code Number 1 响应码
message String success 响应信息

返回示例：

  • 正常返回：

    例：{
        
            "code": 1,
            "message": "success"
        }
3.2 响应码解析

响应码列表

返回码 说明
1 添加白名单成功
1102 参数名错误
1103 参数类型错误
1143 删除失败，IP不在白名单
1155 值格式错误（IP段最大支持c段）
1165 AppKey或AppToken错误
1166 类型格式错误
1188 您的IP不在平台白名单中,请添加IP到平台白名单
3.3 示例代码

3.3.1 Python


    import requests

    data = {
        'AppKey': '01HQ********RLO9',
        'AppToken': '10t5********ntz3',
        'WhiteType': 1,
        'Value': '6.6.6.6'
    }
    
    response = requests.post('https://tj.wuthreat.com/tj/next_captcha/api_control/del_white', data=data)

3.3.2 Java


        Request request = Request.Post("https://tj.wuthreat.com/tj/next_captcha/api_control/del_white"); 
        String body = "AppKey=01HQ********RLO9&AppToken=10t5********ntz3&WhiteType=1&Value=8.8.8.8"; 
        request.bodyString(body,ContentType.APPLICATION_FORM_URLENCODED); request.setHeader("Content-Type", "application/x-www-form-urlencoded"); 
        HttpResponse httpResponse = request.execute().returnResponse(); System.out.println(httpResponse.getStatusLine()); 
        if (httpResponse.getEntity() != null) { 
                String html = EntityUtils.toString(httpResponse.getEntity()); 
                System.out.println(html); 
        }