URL风险异步检测API

接入指引

1. 注册阿里云账号：立即注册，按照操作提示完成账号注册。

2. 开通内容安全按量付费：请确保您已开通服务，开通不收费，接口接入使用后系统会按使用量自动出账，详情请参见计费说明。您也可以购买按量抵扣资源包，资源包相较于后付费存在一定阶梯抵扣，适合使用量级可预期和较大的用户。

3. 创建AccessKey：请确保您已通过RAM创建AccessKey，如果您使用的是子账号AccessKey，您需要通过主账号给子账号赋予AliyunYundunGreenWebFullAccess权限，具体操作，请参见RAM授权。

4. 开发接入：推荐使用SDK方式调用，具体方法请详见URL风险检测接入指南。

5. URL风险检测异步服务包含以下2个接口：

   • UrlAsyncModeration：提交URL风险检测任务

   • DescribeUrlModerationResult：获取URL风险检测结果

提交审核任务

使用说明

• 业务接口：UrlAsyncModeration

• 支持的地域及接入地址：

• 计费信息：

  该接口为收费接口。仅对HTTP状态码为200的请求进行计量计费，产生其他错误码时不会计费。关于计费方式，请参见URL风险检测介绍及计费说明。

• 返回结果：异步检测任务不会实时返回检测结果，您需要通过callback或者轮询的方式获取检测结果。检测结果最长保留3天。

  • callback获取检测结果：提交异步检测任务时，在请求参数中传入callback参数，用来自动接收检测结果。

  • 轮询获取检测结果：提交异步检测任务时，无需传入callback参数；提交异步检测任务后，调用结果查询接口获取检测结果。异步检测当前为排队检测，结果会在24小时内检测完毕。

• 支持URL格式：

  URL风险检测服务支持符合以下格式的URL地址：http(s)://{IP或域名}{:端口}{/路径}

  说明

  1. URL地址可以没有HTTP或HTTPS前缀

  2. 域名部分是数字、字母组成，英文点号分隔，一级域名2-6个字母

  3. 端口部分支持1-4个数字

  4. 路径支持数字、字母、及常见字符，例如_!~*'().;?:@&=+$,%#-)等，不能有中文

  如果输入URL地址不符合该格式，会返回错误码 400。

QPS限制

本接口的单用户QPS限制为100次/秒。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。如果您业务量级较大或者有紧急扩容需求需要更大QPS，请联系您的商务经理。

调试

在接入前，您也可以通过阿里云OpenAPI在线调试提交URL风险检测任务的接口，查看调用示例代码及SDK依赖信息，方便概览接口的使用方法和参数。

请求参数

表 1. ServiceParameters

返回数据

示例

请求示例

{
    "Service": "url_detection_pro",
    "ServiceParameters": {
        "url": "https://help.aliyun.com/",
        "dataId": "url123******"
    }
}

返回示例

{
    "Msg": "OK",
    "Code": 200,
    "RequestId": "ABCD1234-1234-1234-1234-1234XYZ",
    "Data": {
        "ReqId": "ABCD1234-1234-1234-1234-1234XYZ",
        "DataId": "url123******"
    }
}

获取审核任务结果

接口说明

• 业务接口：DescribeUrlModerationResult，表示获取URL风险检测任务结果。

• 计费信息：该接口不计费。

• 查询超时：建议您将查询间隔设置为5分钟（即在提交异步检测任务5分钟之后查询结果），最长不能超出3天，否则结果将会自动删除。

QPS限制

本接口的单用户QPS限制为100次/秒。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。

调试

在接入前，您也可以通过阿里云OpenAPI在线调试获取URL风险检测任务结果的接口，查看调用示例代码及SDK依赖信息，方便概览接口的使用方法和参数。

请求参数

返回数据

示例

请求示例

{
    "ReqId": "ABCD1234-1234-1234-1234-123****"
}

返回示例

{
    "Msg": "OK",
    "Code": 200,
    "Data": {
        "DataId": "img123****",
        "Result": [
            {
                "Label": "sexual_url",
                "Confidence": 81.18
            }
        ],
        "ExtraInfo": {
            "IcpType": "企业",
            "IcpNo": "ICP备123456789"
        }
    },
    "RequestId": "ABCD1234-1234-1234-1234-123****"
}

Code说明

以下为接口返回code的含义说明，系统仅对code返回为200的请求计量计费，其他code不会计费。