UrlAsyncModeration - URL风险异步检测-阿里云帮助中心

接口说明

URL 异步检测服务支持按量后付费和资源包抵扣两种付费方式。

当您开通文本审核增强版服务后，默认付费方式是按量后付费，且按照实际用量结算当日费用，不调用服务不收费，30 元/万次。
如果您的审核量较大，或有相对固定的审核需求，建议预先购买资源包的方式。购买资源包规格越大，享受的折扣越大，支持叠加购买和使用。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

yundun-greenweb:UrlAsyncModeration

none

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
Service	string	否	服务名称：URL 风险链接检测	URL风险链接检测：url_detection_pro
ServiceParameters	string	否	内容检测对象的相关参数集，JSON 字符串格式，请参见 ServiceParameters 说明。	{ "url": "https://help.aliyun.com/", "dataId": "url123******" }

ServiceParameters 说明

名称	类型	是否必选	示例值	描述
url	String	是	https://help.aliyun.com/	待检测的 URL。说明请确保该 URL 符合 URL 格式要求。且一次请求请确保仅传入 1 条 URL。
dataId	String	否	url123****	检测对象对应的数据 ID。由大小写英文字母、数字、下划线（_）、短划线（-）、英文句号（.）组成，不超过 64 个字符，可以用于唯一标识您的业务数据。
callback	String	否	http://www.aliyun.com	检测结果回调通知您的 URL，支持使用 HTTP 和 HTTPS 协议的地址。该字段为空时，您必须定时轮询检测结果。callback 接口必须支持 POST 方法、UTF-8 编码的传输数据，以及表单参数 ReqId，Checksum 和 Content。内容安全按照以下规则和格式设置 ReqId，Checksum 和 Content，调用您的 callback 接口返回检测结果。- ReqId：提交异步检测任务返回的请求 ID。- Checksum：字符串格式，由用户 uid + seed + content 拼成字符串，通过 SHA256 算法生成。用户 UID 即阿里云账号 ID，可以在阿里云控制台查询。为防篡改，您可以在获取到推送结果时，按上述算法生成字符串，与 Checksum 做一次校验。说明用户 UID 必须是阿里云账号的 UID，而不是 RAM 用户的 UID。- Content：JSON 字符串格式，请自行解析反转成 JSON 对象。关于 Content 结果的示例，请参见查询检测结果的返回示例。说明您的服务端 callback 接口收到内容安全推送的结果后，如果返回的 HTTP 状态码为 200，则表示接收成功，其他的 HTTP 状态码均视为接收失败。接收失败时，内容安全将最多重复推送 16 次检测结果，直到接收成功。重复推送 16 次后仍未接收成功，则不再推送，建议您检查 callback 接口的状态。
seed	String	否	abc****	随机字符串，该值用于回调通知请求中的签名。由英文字母、数字、下划线（_）组成，不超过 64 个字符。由您自定义，用于在接收到内容安全的回调通知时校验请求由阿里云内容安全服务发起。说明当使用 callback 时，该字段必须提供。
cryptType	String	否	SHA256	使用回调通知时（callback），设置对回调通知内容进行加密的算法。内容安全会将返回结果（由用户 uid + seed + content拼接的字符串）按照您设置的加密算法加密后，再发送到您的回调通知地址。取值：●SHA256（默认）：使用 SHA256 加密算法。●SM3：使用国密 HMAC-SM3 加密算法，返回十六进制的字符串，且字符串由小写字母和数字组成。例如，abc 经国密 SM3 加密后返回。

返回参数

名称	类型	描述	示例值
	object	Schema of Response
RequestId	string	Id of the request	6CF2815C-**--B52E-FF6E2**492
Code	integer	返回码。返回 200 代表成功。	200
Msg	string	本次请求的响应消息。	success
Data	object	返回数据。
ReqId	string	URL 异步审核增强版 API 返回的 ReqId 字段，可用此字段查询检测结果。	A07B3DB9-D762-5C56-95B1-8EC55CF176D2
DataId	string	API 请求时传入的 dataId 的值，如请求时未传入，则没有该字段。	26769ada6e264e7ba9aa048241e12be9

示例

正常返回示例

JSON格式

{
  "RequestId": "6CF2815C-****-****-B52E-FF6E2****492",
  "Code": 200,
  "Msg": "success",
  "Data": {
    "ReqId": "A07B3DB9-D762-5C56-95B1-8EC55CF176D2",
    "DataId": "26769ada6e264e7ba9aa048241e12be9"
  }
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。