接入指引

1. 注冊阿里云賬號：立即注冊，按照操作提示完成賬號注冊。

2. 開通內容安全按量付費：請確保您已開通服務，開通不收費，接口接入使用后系統會按使用量自動出賬，詳情請參見URL風險檢測介紹及計費說明。您也可以購買按量抵扣資源包，資源包相較于后付費存在一定階梯抵扣，適合使用量級可預期和較大的用戶。

3. 創建AccessKey：請確保您已通過RAM創建AccessKey，如果您使用的是子賬號AccessKey，您需要通過主賬號給子賬號賦予AliyunYundunGreenWebFullAccess權限，具體操作，請參見RAM授權。

4. 開發接入：推薦使用SDK方式調用，具體方法請詳見接入指南。

使用說明

您可以調用該接口創建文本內容檢測任務。關于如何構造HTTP請求，請參見HTTPS原生調用；您也可以直接選用已構造好的HTTP請求，更多信息，請參見接入指南。

• 業務接口：https://green-cip.{region}.aliyuncs.com。

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

  地域	外網接入地址	內網接入地址
  華東2（上海）	https://green-cip.cn-shanghai.aliyuncs.com	https://green-cip-vpc.cn-shanghai.aliyuncs.com
  華東1（杭州）	https://green-cip.cn-hangzhou.aliyuncs.com	https://green-cip-vpc.cn-hangzhou.aliyuncs.com
  華北2（北京）	https://green-cip.cn-beijing.aliyuncs.com	https://green-cip-vpc.cn-beijing.aliyuncs.com
  華南1（深圳）	https://green-cip.cn-shenzhen.aliyuncs.com	暫無
  西南1（成都）	https://green-cip.cn-chengdu.aliyuncs.com	暫無

• 計費信息：

  該接口為收費接口。僅對HTTP狀態碼為200的請求進行計量計費，產生其他錯誤碼時不會計費。關于計費方式，請參見URL風險檢測介紹及計費說明。

• 支持URL格式：

  URL風險檢測服務支持符合以下格式的URL地址：http(s)://{IP或域名}{:端口}{/路徑}

  說明

  1. URL地址可以沒有HTTP或HTTPS前綴

  2. 域名部分是數字、字母組成，英文點號分隔，一級域名2-6個字母

  3. 端口部分支持1-4個數字

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

  如果輸入URL地址不符合該格式，會返回錯誤碼 BAD_REQUEST(400)。

QPS限制

本接口的單用戶QPS限制為100次/秒。超過限制，API調用會被限流，這可能會影響您的業務，請合理調用。

調試

在接入前，您也可以通過阿里云OpenAPI在線調試文本審核增強版的接口，查看調用示例代碼及SDK依賴信息，方便概覽接口的使用方法和參數。

請求參數

返回參數

示例

請求示例

{
    "Service": "url_detection",
    "ServiceParameters": "{\"content\":\"http://aliyun.com/abc\",\"accountId\":\"10123****\"}"
}

返回示例

{
    "Code": 200,
    "Data": {
        "Labels": "unmarked_url",
        "Reason": "{\"icpType\":\"企業\",\"icpNo\":\"ICP123XXXX789\",\"score\":\"60\"}"
    },
    "Message": "OK",
    "RequestId": "AAAAAA-BBBB-CCCCC-DDDD-EEEEEEEE****"
}

Code說明

以下為接口返回code的含義說明，系統僅對code返回為200的請求計量計費，其他code不會計費。