调用API
您可以基于网关为您提供的SDK编写代码调用API,目前提供web端和移动端主流语言的SDK,后续会持续丰富语言种类。您还可以自行编辑HTTP请求调用API。
通过上述步骤,您从服务商处获得域名、Path、参数说明等信息,您创建的APP作为您的请求身份,AppKey和AppSecret用于计算加密签名。确定您的APP获得了授权后,您就可以调用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时,无论使用HTTP还是HTTPS协议提交请求,都需要在请求中包含签名信息。AppKey用于标识您的身份,AppSecret是用于加密签名字符串和服务器端验证签名字符串的密钥。详细加密签名的计算传递方式,请查看文档——入口及协议
若需要了解更多详情,请您查看使用手册(调用API)。