Python SDK

支持Python 3.6及以上版本。

1. 執行如下命令安裝pip。

   pip install alibabacloud_green20220302==2.2.0

2. 接入Python SDK。

   • 提交URL風險檢測任務代碼示例

     from alibabacloud_green20220302.client import Client
     from alibabacloud_green20220302 import models
     from alibabacloud_tea_openapi.models import Config
     from alibabacloud_tea_util import models as util_models
     import json
     import os
     import uuid
     
     
     # 創建請求客戶端
     def create_client(access_key_id, access_key_secret, endpoint):
         config = Config(
             access_key_id=access_key_id,
             access_key_secret=access_key_secret,
             # 設置http代理。
             # http_proxy='http://10.10.xx.xx:xxxx',
             # 設置https代理。
             # https_proxy='https://10.10.xx.xx:xxxx',
             # 接入區域和地址請根據實際情況修改。
             endpoint=endpoint
         )
         return Client(config)
     
     
     def invoke_function(access_key_id, access_key_secret, endpoint):
         # 注意：此處實例化的client請盡可能重復使用，避免重復建立連接，提升檢測性能。
         client = create_client(access_key_id, access_key_secret, endpoint)
         # 創建RuntimeObject實例并設置運行參數。
         runtime = util_models.RuntimeOptions()
     
         # 檢測參數構造。
         service_parameters = {
             # 公網可訪問的url。
             'url': 'https://www.aliyun.com/',
             # 數據唯一標識
             'dataId': str(uuid.uuid1()),
             # 檢測結果回調通知您的URL。
             'callback': 'http://www.aliyun.com',
             # 隨機字符串，該值用于回調通知請求中的簽名。
             'seed': 'seedCode',
             # 使用回調通知時（callback），設置對回調通知內容進行簽名的算法。
             'cryptType': 'SM3'
         }
     
         url_image_moderation_request = models.UrlAsyncModerationRequest(
             # url檢測service,示例：url_detection_pro
             service='url_detection_pro',
             service_parameters=json.dumps(service_parameters)
         )
     
         try:
             return client.url_async_moderation_with_options(url_image_moderation_request, runtime),
         except Exception as err:
             print(err)
     
     
     if __name__ == '__main__':
         access_key_id = os.environ['ALIBABA_CLOUD_ACCESS_KEY_ID']
         access_key_secret = os.environ['ALIBABA_CLOUD_ACCESS_KEY_SECRET']
         # 接入區域和地址請根據實際情況修改。
         response = invoke_function(access_key_id, access_key_secret, 'green-cip.cn-shanghai.aliyuncs.com')
         # 打印結果。
         if len(response) >= 1:
             if response[0].status_code == 200:
                 # 調用成功。
                 # 獲取結果ReqId。
                 result = response[0].body
                 print('response success. result:{}'.format(result))
                 if result.code == 200:
                     result_data = result.data
                     print('result: {}'.format(result_data))
             else:
                 print('response not success. status:{} ,result:{}'.format(response.status_code, response))

   • 獲取URL風險檢測任務結果代碼示例

     from alibabacloud_green20220302.client import Client
     from alibabacloud_green20220302 import models
     from alibabacloud_tea_openapi.models import Config
     from alibabacloud_tea_util import models as util_models
     import os
     
     
     # 創建請求客戶端
     def create_client(access_key_id, access_key_secret, endpoint):
         config = Config(
             access_key_id=access_key_id,
             access_key_secret=access_key_secret,
             # 設置http代理。
             # http_proxy='http://10.10.xx.xx:xxxx',
             # 設置https代理。
             # https_proxy='https://10.10.xx.xx:xxxx',
             # 接入區域和地址請根據實際情況修改。
             endpoint=endpoint
         )
         return Client(config)
     
     
     def invoke_function(access_key_id, access_key_secret, endpoint):
         # 注意：此處實例化的client請盡可能重復使用，避免重復建立連接，提升檢測性能。
         client = create_client(access_key_id, access_key_secret, endpoint)
         # 創建RuntimeObject實例并設置運行參數。
         runtime = util_models.RuntimeOptions()
     
         # 構造請求入參。
         describe_result_request = models.DescribeUrlModerationResultRequest(
             # 將提交異步檢測任務時返回值中的ReqId作為獲取結果的入參。例如：DFEXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXX44
             req_id='DFEXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXX44',
         )
     
         try:
             return client.describe_url_moderation_result_with_options(describe_result_request, runtime)
         except Exception as err:
             print(err)
     
     
     if __name__ == '__main__':
         access_key_id = os.environ['ALIBABA_CLOUD_ACCESS_KEY_ID']
         access_key_secret = os.environ['ALIBABA_CLOUD_ACCESS_KEY_SECRET']
         # 接入區域和地址請根據實際情況修改。
         response = invoke_function(access_key_id, access_key_secret, 'green-cip.cn-shanghai.aliyuncs.com')
         # 打印結果。
         if response is not None:
             if response.status_code == 200:
                 # 調用成功。
                 # 獲取審核結果。
                 result = response.body
                 print('response success. result:{}'.format(result))
                 if result.code == 200:
                     result_data = result.data
                     print('result: {}'.format(result_data))
             else:
                 print('response not success. status:{} ,result:{}'.format(response.status_code, response))

PHP SDK

支持PHP 5.6及以上版本。

1. 執行如下命令引入相關依賴。

   composer require alibabacloud/green-20220302 2.2.0

2. 接入PHP SDK。

   • 提交URL風險檢測任務代碼示例

     <?php
     require('../../../vendor/autoload.php');
     
     use AlibabaCloud\SDK\Green\V20220302\Models\UrlAsyncModerationResponse;
     use Darabonba\OpenApi\Models\Config;
     use AlibabaCloud\Tea\Utils\Utils\RuntimeOptions;
     use AlibabaCloud\SDK\Green\V20220302\Green;
     use AlibabaCloud\SDK\Green\V20220302\Models\UrlAsyncModerationRequest;
     
     /**
      * 創建請求客戶端
      * @param $accessKeyId
      * @param $accessKeySecret
      * @param $endpoint
      * @return Green
      */
     function create_client($accessKeyId, $accessKeySecret, $endpoint): Green
     {
         $config = new Config([
             "accessKeyId" => $accessKeyId,
             "accessKeySecret" => $accessKeySecret,
             // 設置HTTP代理。
             // "httpProxy" => "http://10.10.xx.xx:xxxx",
             // 設置HTTPS代理。
             // "httpsProxy" => "https://10.10.xx.xx:xxxx",
             "endpoint" => $endpoint,
         ]);
         return new Green($config);
     }
     
     /**
      * 提交檢測任務
      * @param $accessKeyId
      * @param $accessKeySecret
      * @param $endpoint
      * @return UrlAsyncModerationResponse
      */
     function invoke($accessKeyId, $accessKeySecret, $endpoint): UrlAsyncModerationResponse
     {
         // 注意：此處實例化的client請盡可能重復使用，避免重復建立連接，提升檢測性能。
         $client = create_client($accessKeyId, $accessKeySecret, $endpoint);
         // 創建RuntimeObject實例并設置運行參數。
         $runtime = new RuntimeOptions([]);
         // 檢測參數構造。
         $request = new UrlAsyncModerationRequest();
         $serviceParameters = array(
             // 待檢測url，公網可訪問的URL。
             'url' => 'https://aliyun.com',
             // 檢測數據唯一標識。
             'dataId' => uniqid(),
             // 檢測結果回調通知您的URL。
             'callback' => 'http://www.aliyun.com',
             //隨機字符串，該值用于回調通知請求中的簽名。
             'seed' => 'seedCode',
             // 使用回調通知時（callback），設置對回調通知內容進行簽名的算法。
             'cryptType' => 'SM3'
         );
         // URL檢測service,示例：url_detection_pro
         $request->service = "url_detection_pro";
         $request->serviceParameters = json_encode($serviceParameters);
         // 提交檢測
         return $client->urlAsyncModerationWithOptions($request, $runtime);
     }
     
     $accessKeyId = getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
     $accessKeySecret = getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
     $endpoint = "green-cip.cn-shanghai.aliyuncs.com";
     
     try {
         $response = invoke($accessKeyId, $accessKeySecret, $endpoint);
         //返回結果中包含reqId字段，獲取異步檢測結果時將該字段作為入參，獲取圖片檢測結果
         print_r(json_encode($response->body, JSON_UNESCAPED_UNICODE));
     } catch (Exception $e) {
         var_dump($e->getMessage());
         var_dump($e->getErrorInfo());
         var_dump($e->getLastException());
         var_dump($e->getLastRequest());
     }

   • 獲取URL風險檢測任務結果代碼示例

     <?php
     require('../../../vendor/autoload.php');
     
     use AlibabaCloud\SDK\Green\V20220302\Models\DescribeUrlModerationResultResponse;
     use Darabonba\OpenApi\Models\Config;
     use AlibabaCloud\Tea\Utils\Utils\RuntimeOptions;
     use AlibabaCloud\SDK\Green\V20220302\Green;
     use AlibabaCloud\SDK\Green\V20220302\Models\DescribeUrlModerationResultRequest;
     
     /**
      * 創建請求客戶端
      * @param $accessKeyId
      * @param $accessKeySecret
      * @param $endpoint
      * @return Green
      */
     function create_client($accessKeyId, $accessKeySecret, $endpoint): Green
     {
         $config = new Config([
             "accessKeyId" => $accessKeyId,
             "accessKeySecret" => $accessKeySecret,
             "endpoint" => $endpoint,
         ]);
         return new Green($config);
     }
     
     /**
      * 提交檢測任務
      * @param $accessKeyId
      * @param $accessKeySecret
      * @param $endpoint
      * @return DescribeUrlModerationResultResponse
      */
     function invoke($accessKeyId, $accessKeySecret, $endpoint): DescribeUrlModerationResultResponse
     {
         // 注意：此處實例化的client請盡可能重復使用，避免重復建立連接，提升檢測性能。
         $client = create_client($accessKeyId, $accessKeySecret, $endpoint);
         // 創建RuntimeObject實例并設置運行參數。
         $runtime = new RuntimeOptions([]);
         // 請求參數構造。
         $request = new DescribeUrlModerationResultRequest();
         // 將提交異步檢測任務時返回值中的reqId作為獲取結果的入參。例如：DFEXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXX44
         $request->reqId = "DFEXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXX44";
         // 提交檢測
         return $client->describeUrlModerationResultWithOptions($request, $runtime);
     }
     
     $accessKeyId = getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
     $accessKeySecret = getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
     $endpoint = "green-cip.cn-shanghai.aliyuncs.com";
     
     try {
         $response = invoke($accessKeyId, $accessKeySecret, $endpoint);
         print_r(json_encode($response->body, JSON_UNESCAPED_UNICODE));
     } catch (Exception $e) {
         var_dump($e->getMessage());
         var_dump($e->getErrorInfo());
         var_dump($e->getLastException());
         var_dump($e->getLastRequest());
     }

Go SDK

1. 執行如下命令引入相關依賴。

   go get github.com/alibabacloud-go/green-20220302/v2

2. 接入Go SDK。

   • 提交URL風險檢測任務代碼示例

     package main
     
     import (
     	"encoding/json"
     	"fmt"
     	openapi "github.com/alibabacloud-go/darabonba-openapi/v2/client"
     	green20220302 "github.com/alibabacloud-go/green-20220302/v2/client"
     	util "github.com/alibabacloud-go/tea-utils/v2/service"
     	"github.com/alibabacloud-go/tea/tea"
     	"github.com/google/uuid"
     	"net/http"
     	"os"
     )
     
     //創建請求客戶端
     func createClient(accessKeyId *string, accessKeySecret *string, endpoint *string) (*green20220302.Client, error) {
     	config := &openapi.Config{
     		/**
     		 * 阿里云賬號AccessKey擁有所有API的訪問權限，建議您使用RAM用戶進行API訪問或日常運維。
     		 * 強烈建議不要把AccessKey ID和AccessKey Secret保存到工程代碼里，否則可能導致AccessKey泄露，威脅您賬號下所有資源的安全。
     		 * 常見獲取環境變量方式：
     		 * 獲取RAM用戶AccessKey ID：os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")
     		 * 獲取RAM用戶AccessKey Secret：os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")
     		 */
     		AccessKeyId:     accessKeyId,
     		AccessKeySecret: accessKeySecret,
     		// 設置HTTP代理。
     		// HttpProxy: tea.String("http://10.10.xx.xx:xxxx"),
     		// 設置HTTPS代理。
     		// HttpsProxy: tea.String("https://username:password@xxx.xxx.xxx.xxx:9999"),
     		Endpoint: endpoint,
     	}
     	//注意，此處實例化的client請盡可能重復使用，避免重復建立連接，提升檢測性能。
     	return green20220302.NewClient(config)
     }
     
     func invoke(accessKeyId *string, accessKeySecret *string, endpoint *string) (_result *green20220302.UrlAsyncModerationResponse, _err error) {
     	//注意，此處實例化的client請盡可能重復使用，避免重復建立連接，提升檢測性能。
     	client, _err := createClient(accessKeyId, accessKeySecret, endpoint)
     	if _err != nil {
     		return nil, _err
     	}
     	//運行時參數設置，僅對使用了該運行時參數實例的請求有效
     	runtime := &util.RuntimeOptions{}
     
     	//構建圖片檢測請求。
     	serviceParameters, _ := json.Marshal(
     		map[string]interface{}{
     			// 待檢測url鏈接，公網可訪問的URL。
     			"url": "https://www.aliyun.com",
     			// 待檢測數據的ID。
     			"dataId": uuid.New(),
     			// 檢測結果回調通知您的URL。
     			"callback": "http://www.aliyun.com",
     			// 隨機字符串，該值用于回調通知請求中的簽名。
     			"seed": "seedCode",
     			// 使用回調通知時（callback），設置對回調通知內容進行簽名的算法。
     			"cryptType": "SM3",
     		},
     	)
     	imageModerationRequest := &green20220302.UrlAsyncModerationRequest{
     		//url檢測service,示例：url_detection_pro
     		Service:           tea.String("url_detection_pro"),
     		ServiceParameters: tea.String(string(serviceParameters)),
     	}
     
     	return client.UrlAsyncModerationWithOptions(imageModerationRequest, runtime)
     
     }
     
     func main() {
     	/**
     	 * 阿里云賬號AccessKey擁有所有API的訪問權限，建議您使用RAM用戶進行API訪問或日常運維。
     	 * 強烈建議不要把AccessKey ID和AccessKey Secret保存到工程代碼里，否則可能導致AccessKey泄露，威脅您賬號下所有資源的安全。
     	 * 常見獲取環境變量方式：
     	 * 獲取RAM用戶AccessKey ID：os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")
     	 * 獲取RAM用戶AccessKey Secret：os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")
     	 */
     	//var accessKeyId= tea.String("建議從環境變量中獲取RAM用戶AccessKey ID");
     	//var accessKeySecret= tea.String("建議從環境變量中獲取RAM用戶AccessKey Secret");
     	var accessKeyId = tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"))
     	var accessKeySecret = tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"))
     	//接入區域和地址請根據實際情況修改
     	var endpoint = tea.String("green-cip.cn-shanghai.aliyuncs.com")
     	response, _err := invoke(accessKeyId, accessKeySecret, endpoint)
     
     	if response != nil {
     		statusCode := tea.IntValue(tea.ToInt(response.StatusCode))
     		body := response.Body
     		imageModerationResponseData := body.Data
     		if statusCode == http.StatusOK {
     			fmt.Println("response success. response:" + body.String())
     			if tea.IntValue(tea.ToInt(body.Code)) == 200 {
     				// 返回結果中包含ReqId字段，獲取異步檢測結果時將該字段作為入參，獲取圖片檢測結果
     				fmt.Println("response ReqId:" + tea.StringValue(imageModerationResponseData.ReqId))
     			} else {
     				fmt.Println("url moderation not success. status" + tea.ToString(body.Code))
     			}
     		} else {
     			fmt.Print("response not success. status:" + tea.ToString(statusCode))
     			fmt.Println("Error:", _err)
     		}
     	}
     }

   • 獲取URL風險檢測任務結果代碼示例

     package main
     
     import (
     	"fmt"
     	openapi "github.com/alibabacloud-go/darabonba-openapi/v2/client"
     	green20220302 "github.com/alibabacloud-go/green-20220302/v2/client"
     	util "github.com/alibabacloud-go/tea-utils/v2/service"
     	"github.com/alibabacloud-go/tea/tea"
     	"net/http"
     	"os"
     )
     
     //創建請求客戶端
     func createClient(accessKeyId *string, accessKeySecret *string, endpoint *string) (*green20220302.Client, error) {
     	config := &openapi.Config{
     		/**
     		 * 阿里云賬號AccessKey擁有所有API的訪問權限，建議您使用RAM用戶進行API訪問或日常運維。
     		 * 強烈建議不要把AccessKey ID和AccessKey Secret保存到工程代碼里，否則可能導致AccessKey泄露，威脅您賬號下所有資源的安全。
     		 * 常見獲取環境變量方式：
     		 * 獲取RAM用戶AccessKey ID：os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")
     		 * 獲取RAM用戶AccessKey Secret：os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")
     		 */
     		AccessKeyId:     accessKeyId,
     		AccessKeySecret: accessKeySecret,
     		// 設置HTTP代理。
     		// HttpProxy: tea.String("http://10.10.xx.xx:xxxx"),
     		// 設置HTTPS代理。
     		// HttpsProxy: tea.String("https://username:password@xxx.xxx.xxx.xxx:9999"),
     		Endpoint: endpoint,
     	}
     	//注意，此處實例化的client請盡可能重復使用，避免重復建立連接，提升檢測性能。
     	return green20220302.NewClient(config)
     }
     
     func invoke(accessKeyId *string, accessKeySecret *string, endpoint *string) (_result *green20220302.DescribeUrlModerationResultResponse, _err error) {
     	//注意，此處實例化的client請盡可能重復使用，避免重復建立連接，提升檢測性能。
     	client, _err := createClient(accessKeyId, accessKeySecret, endpoint)
     	if _err != nil {
     		return nil, _err
     	}
     	//運行時參數設置，僅對使用了該運行時參數實例的請求有效
     	runtime := &util.RuntimeOptions{}
     
     	//構建請求。
     	imageModerationRequest := &green20220302.DescribeUrlModerationResultRequest{
     		// 將提交異步檢測任務時返回值中的ReqId作為獲取結果的入參。例如：DFEXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXX44
     		ReqId:           tea.String("DFEXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXX44"),
     	}
     
     	return client.DescribeUrlModerationResultWithOptions(imageModerationRequest, runtime)
     
     }
     
     func main() {
     	/**
     	 * 阿里云賬號AccessKey擁有所有API的訪問權限，建議您使用RAM用戶進行API訪問或日常運維。
     	 * 強烈建議不要把AccessKey ID和AccessKey Secret保存到工程代碼里，否則可能導致AccessKey泄露，威脅您賬號下所有資源的安全。
     	 * 常見獲取環境變量方式：
     	 * 獲取RAM用戶AccessKey ID：os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")
     	 * 獲取RAM用戶AccessKey Secret：os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")
     	 */
     	//var accessKeyId= tea.String("建議從環境變量中獲取RAM用戶AccessKey ID");
     	//var accessKeySecret= tea.String("建議從環境變量中獲取RAM用戶AccessKey Secret");
     	var accessKeyId = tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"))
     	var accessKeySecret = tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"))
     	//接入區域和地址請根據實際情況修改
     	var endpoint = tea.String("green-cip.cn-shanghai.aliyuncs.com")
     	response, _err := invoke(accessKeyId, accessKeySecret, endpoint)
     
     	if response != nil {
     		statusCode := tea.IntValue(tea.ToInt(response.StatusCode))
     		body := response.Body
     		imageModerationResponseData := body.Data
     		fmt.Println("requestId:" + tea.StringValue(body.RequestId))
     		if statusCode == http.StatusOK {
     			fmt.Println("response success. response:" + imageModerationResponseData.String())
     		} else {
     			fmt.Print("response not success. status:" + tea.ToString(statusCode))
     			fmt.Println("Error:", _err)
     		}
     	}
     }