服务接入_云工作流(CloudFlow)-阿里云帮助中心

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

请求结构

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

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

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

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

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

说明

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

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

地域	公网服务接入地址	VPC服务接入地址	经典网络服务接入地址
华东1（杭州）	cn-hangzhou.fnf.aliyuncs.com	cn-hangzhou-internal.fnf.aliyuncs.com	cn-hangzhou-classic.fnf.aliyuncs.com
华东2（上海）	cn-shanghai.fnf.aliyuncs.com	cn-shanghai-internal.fnf.aliyuncs.com	cn-shanghai-classic.fnf.aliyuncs.com
华北2（北京）	cn-beijing.fnf.aliyuncs.com	cn-beijing-internal.fnf.aliyuncs.com	cn-beijing-classic.fnf.aliyuncs.com
华北1（青岛）	cn-qingdao.fnf.aliyuncs.com	cn-qingdao-internal.fnf.aliyuncs.com	cn-qingdao-classic.fnf.aliyuncs.com
华南1（深圳）	cn-shenzhen.fnf.aliyuncs.com	cn-shenzhen-internal.fnf.aliyuncs.com	cn-shenzhen-classic.fnf.aliyuncs.com
新加坡	ap-southeast-1.fnf.aliyuncs.com	ap-southeast-1-internal.fnf.aliyuncs.com	ap-southeast-1-classic.fnf.aliyuncs.com
美国（硅谷）	us-west-1.fnf.aliyuncs.com	us-west-1-internal.fnf.aliyuncs.com	us-west-1-classic.fnf.aliyuncs.com

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

名称	类型	是否必选	示例值	描述
Action	String	是	StartExecution	API的名称。
AccessKeyId	String	是	LTAIp4********fjx	访问密钥ID。更多详情，请参见创建AccessKey。
Signature	String	是	OLeaidS1JvxuMvnyHOwuJ%2BuX5qY%3D	您的签名。更多详情，请参见签名机制。
SignatureMethod	String	是	HMAC-SHA1	签名方式。默认签名方式：HMAC-SHA1。
SignatureVersion	String	是	1.0	签名算法版本。默认版本：1.0。
SignatureNonce	String	是	3ee8c1b8-**-44af-**-4e0ad82fd6cf	签名唯一随机数。用于防止网络重放攻击，建议您每一次请求都使用不同的随机数。
Timestamp	String	是	2024-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。