调用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)。

results matching ""

    No results matching ""