云工作流（CloudFlow）采用RPC风格API，支持GET和POST请求方式。本文提供了调用云工作流API的方法，一次API请求中，会涉及签名、参数设定以及身份验证等设置。
请求结构
此章节讲解HTTP/HTTPS调用场景中，一次API的请求的结构分析。
以下是GET请求的URL格式，字符编码采用UTF-8规范。
http(s)://Endpoint/?Action=xx&ParametersEndpoint：调用的云服务的接入点。
Action：当前请求需要执行的操作，例如使用StartExecution执行一个流程。
Parameters：代指请求参数，由公共请求参数和API自定义参数组成，参数之间使用“&”分隔。
以下是StartExecution接口的请求示例：
https://[Endpoint]/?Action=StartExecution
&FlowName=Flow
&公共请求参数为了获得更高的安全性，建议您使用HTTPS协议发送API请求。
服务接入地址
云工作流API的服务接入地址为：XXX.aliyuncs.com。
网络类型 | 地域 | 公网服务接入地址 | 内网服务接入地址 |
公网服务 | 华东1（杭州） | cn-hangzhou.fnf.aliyuncs.com | cn-hangzhou-internal.fnf.aliyuncs.com |
华东2（上海） | cn-shanghai.fnf.aliyuncs.com | cn-shanghai-internal.fnf.aliyuncs.com | |
华北2（北京） | cn-beijing.fnf.aliyuncs.com | cn-beijing-internal.fnf.aliyuncs.com | |
华北1（青岛） | cn-qingdao.fnf.aliyuncs.com | cn-qingdao-internal.fnf.aliyuncs.com | |
华南1（深圳） | cn-shenzhen.fnf.aliyuncs.com | cn-shenzhen-internal.fnf.aliyuncs.com | |
新加坡 | ap-southeast-1.fnf.aliyuncs.com | ap-southeast-1-internal.fnf.aliyuncs.com | |
美国（硅谷） | us-west-1.fnf.aliyuncs.com | us-west-1-internal.fnf.aliyuncs.com |
公共参数
以下公共请求参数适用于通过URL发送GET请求调用云工作流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 | 是 | 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。 |