接入指引

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": "http://bestwisewords.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不會計費。