概述及调用示例
调用API
您可以通过API网关,调用由其他阿里云用户或者第三方服务商开放的API服务。API网关将为您提供一系列管理服务与支撑。
调用示例
您可以基于API网关提供的SDK,通过编写代码的方式调用API。也可以自行编辑HTTP请求调用API。API的请求结构如下:
//假如,服务地址:a13db7999e494a90819cce500130034d.com
//假如,Path:/web/cloudapi/mapping/service
//假如,Query内容是:a=name,b=12
//则请求的url如下
http://a13db7999e494a90819cce500130034d.com/web/cloudapi/mapping/service?a=name&b=12
//请求的Method
POST HttpMethod:POST
//Headers中需要包含签名信息和部分参数
X-Ca-Version: 1 //API版本
X-Ca-Signature-Headers: X-Ca-Version,X-Ca-Key,X-Ca-Stage,X-Ca-Timestamp //参与签名的Header
X-Ca-Key: 60028305 //AppKey
X-Ca-Stage: test //Stage
X-Ca-Timestamp: 1456905123049 //时间戳
X-Ca-Signature: UAaH/qteir4G9UK4YR+NWdyq+c1rjl0PvtO/C1Qo68U= //签名
//Http标准头
Host: a13db7999e494a90819cce500130034d.com //服务地址
Date: Wed 02 Mar 2016 07:52:02 GMT
User-Agent: Apache-HttpClient/4.1.2 (java 1.6)
Content-Type: application/x-www-form-urlencoded; charset=utf-8
//Body内容
Amount=11&InstanceId=ClientInstanceId&InstanceName=ClientInstanceName
以上内容加上API的入参就构成了API请求。其中,在公测阶段,您需要在线下从提供API的服务方获取API的说明文档,获取服务地址、Path等详细说明。AppKey是您创建的APP的密钥,用于做身份验证。APP是您调用API需要创建的身份。详情将在后续内容中说明。