简介
本产品API协议遵循HTTPS协议。
官方提供SDK方式调用:详见说明文档。
对于原生HTTPS协议方式需要用户自己封装协议,加签解签,详见说明文档。
我们推荐用户使用SDK方式,SDK封装了签名,协议和参数组装。
SDK调用
目前支持JAVA、Python、PHP、C#、Golang 5种SDK。
一、JAVA SDK
JAVA SDK 的环境准备、安装使用可参考: 阿里云SDK开发指南
JAVA Maven依赖:
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>aliyun-java-sdk-saf</artifactId>
<version>1.0.2</version>
</dependency>
JAVA Maven推荐依赖仲裁:
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>aliyun-java-sdk-core</artifactId>
<optional>true</optional>
<version>4.1.1</version>
</dependency>
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>fastjson</artifactId>
<version>1.2.41</version>
</dependency>
<dependency>
<groupId>com.google.code.gson</groupId>
<artifactId>gson</artifactId>
<version>2.8.2</version>
</dependency>
二、Python SDK
Python SDK的环境准备、安装使用可参考:阿里云SDK开发指南
pip install aliyun-python-sdk-core
pip install aliyun-python-sdk-core-v3
pip install aliyun-python-sdk-saf
Python用例:
from aliyunsdkcore import client
from aliyunsdksaf.request.v20180919 import ExecuteRequestRequest
clt = client.AcsClient('<your-access-key-id>','<your-access-key-secret>','cn-shanghai')
# 设置参数
request = ExecuteRequestRequest.ExecuteRequestRequest()
request.set_accept_format('json')
# 产品service请参考[公共参数]文档中的Service字段描述
request.add_query_param('Service', '购买的产品service')
request.add_query_param('ServiceParameters', 'json串')
# 发起请求
response = clt.do_action_with_exception(request)
print(response)
三、PHP SDK
PHP SDK的环境准备、安装使用可参考:阿里云SDK开发指南
PHP用例:
<?php
include_once 'aliyun-openapi-php-sdk/aliyun-php-sdk-core/Config.php';
use saf\Request\V20180919 as saf;
// 初始化
$iClientProfile = DefaultProfile::getProfile("cn-shanghai", "<your-access-key-id>", "<your-access-key-secret>");
$client = new DefaultAcsClient($iClientProfile);
// 设置参数
$request = new saf\ExecuteRequestRequest();
// 产品service请参考[公共参数]文档中的Service字段描述
$request->setService('购买的产品service');
$request->setServiceParameters('json串');
// 发起请求
$response = $client->getAcsResponse($request);
print_r("<br>");
print_r("test");
print_r("\r\n");
print_r($response);
print_r($client);
?>
四、C# SDK
C# SDK的环境准备、安装使用可参考: 阿里云SDK开发指南
五、Golang SDK
Golang SDK的环境准备、安装使用可参考:阿里云SDK开发指南
Golang用例:
package main
import (
"fmt"
"github.com/aliyun/alibaba-cloud-sdk-go/services/saf"
)
func main() {
client, err := saf.NewClientWithAccessKey("cn-shanghai", "<your-access-key-id>", "<your-access-key-secret>")
request := saf.CreateExecuteRequestRequest()
// 产品service请参考[公共参数]文档中的Service字段描述
request.Service = "购买的产品service"
request.ServiceParameters = "json串"
request.Scheme = "https"
response, err := client.ExecuteRequest(request)
if err != nil {
fmt.Print(err.Error())
}
fmt.Printf("response code is %#v\n", response.Code)
fmt.Printf("response date is %#v\n", response.Data)
fmt.Printf("response message is %#v\n", response.Message)
fmt.Printf("response requestId is %#v\n", response.RequestId)
}
HTTPS原生调用
详细参照HTTPS原生调用说明文档。