如何调用Serverless工作流API-阿里云帮助中心

Serverless 工作流采用RPC风格API，支持GET和POST请求方式。本文提供了调用Serverless 工作流API的方法，一次API请求中，会涉及签名、参数设定以及身份验证等设置。

请求结构

此章节讲解HTTP/HTTPS调用场景中，一次API的请求的结构分析。

以下是GET请求的URL格式，字符编码采用UTF-8规范。

http(s)://Endpoint/?Action=xx&Parameters

以下是StartExecution接口的请求示例：

https://[Endpoint]/?Action=StartExecution
&FlowName=Flow
&公共请求参数

说明为了获得更高的安全性，建议您使用HTTPS协议发送API请求。

Serverless 工作流API的服务接入地址为：XXX.aliyuncs.com。

网络类型	地域	服务接入地址
公网服务	华东1（杭州）	{account-id}.cn-hangzhou.fnf.aliyuncs.com
	华东2（上海）	{account-id}.cn-shanghai.fnf.aliyuncs.com
	华北2（北京）	{account-id}.cn-beijing.fnf.aliyuncs.com
	华南1（深圳）	{account-id}.cn-shenzhen.fnf.aliyuncs.com
	美国（硅谷）	{account-id}.us-west-1.fnf.aliyuncs.com
	新加坡	{account-id}.ap-southeast-1.fnf.aliyuncs.com
内网服务	华东1（杭州）	{account-id}.cn-hangzhou-internal.fnf.aliyuncs.com
	华东2（上海）	{account-id}.cn-shanghai-internal.fnf.aliyuncs.com
	华北2（北京）	{account-id}.cn-beijing-internal.fnf.aliyuncs.com
	华南1（深圳）	{account-id}.cn-shenzhen-internal.fnf.aliyuncs.com
	美国（硅谷）	{account-id}.us-west-1-internal.fnf.aliyuncs.com
	新加坡	{account-id}.ap-southeast-1-internal.fnf.aliyuncs.com

说明表格中的{account-id}需要修改为您的阿里云（主）账号ID，您可以在控制台单击右上角头像，查看企业别名即是您的账号ID。

以下公共请求参数适用于通过URL发送GET请求调用Serverless 工作流API。

名称	类型	是否必选	示例值	描述
Action	String	是	StartExecution	API的名称。
AccessKeyId	String	是	LTAIp4********fjx	访问密钥ID。更多详情，请参见创建AccessKey。
Signature	String	是	OLeaidS1JvxuMvnyHOwuJ%2BuX5qY%3D	您的签名。更多详情，请参见RPC调用机制。
SignatureMethod	String	是	HMAC-SHA1	签名方式。默认签名方式：HMAC-SHA1。
SignatureVersion	String	是	1.0	签名算法版本。默认版本：1.0。
SignatureNonce	String	是	3ee8c1b8-**-44af-**-4e0ad82fd6cf	签名唯一随机数。用于防止网络重放攻击，建议您每一次请求都使用不同的随机数。
Timestamp	String	是	2018-01-01T12:00:00Z	请求的时间戳。按照ISO8601标准表示，并使用UTC+0时间，格式为yyyy-MM-ddTHH:mm:ssZ。
Version	String	是	2019-03-15	API的版本号，格式为YYYY-MM-DD。默认API的版本号：2019-03-15。
Format	String	否	json	返回参数的语言类型。语言类型为JSON或XML格式。默认的语言类型：JSON。