阿里云API网关服务-API手册-D

《阿里云API网关服务-API手册-D》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

1、API网关使用手册（调用API）API网关/使用手册（调用API）使用手册（调用API）调用API您可以通过API网关，调用由其他阿里云用户或者第三方服务商开放的API服务。API网关将为您提供一系列管理服务与支撑。调用示例您可以基于API网关提供的SDK，通过编写代码的方式调用API。也可以自行编辑HTTP请求调用API。API的请求结构如下：//假如，域名：a13db7999e494a90819cce500130034d.com//假如，Path：/web/cloudapi/mapping/service//假如，Query内容是：a=n

2、ame，b=12http://a13db7999e494a90819cce500130034d.com/web/cloudapi/mapping/service？a=name&b=12//则请求的url如下//请求的MethodPOSTHttpMethod：POST//Headers中需要包含签名信息和部分参数X-Ca-Version:1//API版本X-Ca-Signature-Headers:X-Ca-Version,X-Ca-Key,X-Ca-Stage,X-Ca-Timestamp//参与签名的HeaderX-Ca-Key:60028

3、305//AppKeyX-Ca-Stage:test//StageX-Ca-Timestamp:1456905123049//时间戳X-Ca-Signature:UAaH/qteir4G9UK4YR+NWdyq+c1rjl0PvtO/C1Qo68U=//签名//详细加密签名的计算传递方式，请查看文档--入口及协议。//Http标准头//服务地址Host:a13db7999e494a90819cce500130034d.comDate:Wed02Mar201607:52:02GMT5API网关/使用手册（调用API）User-Agent:Apa

4、che-HttpClient/4.1.2(java1.6)Content-Type:application/x-www-form-urlencoded;charset=utf-8Amount=11&InstanceId=ClientInstanceId&InstanceName=ClientInstanceName//Body内容以上内容加上API的入参就构成了API请求。其中，在公测阶段，您需要在线下从提供API的服务方获取API的说明文档，获取服务地址、Path等详细说明。AppKey是您创建的APP的密钥，用于做身份验证。APP是您调用

5、API需要创建的身份。详情将在后续内容中说明。应用（APP）您需要创建应用（APP）作为您调用API的身份，每个APP有一对AppKey和AppSecret密钥对，用于您请求时做加密签名，网关会对签名做验证。1.在API网关，您需要创建应用（APP）作为请求者的身份。APP创建时，系统会自动分配一对AppKey和AppSecret，AppKey用于标识您的身份，AppSecret是用于加密签名字符串和服务器端验证签名字符串的密钥。调用API时您需要将AppKey和AppSecret加密签名放入请求参数，API网关会通过对称加密来验证您的身份。

6、详细加密签名的计算传递方式，请查看文档--入口及协议。2.AppKey和AppSecret密钥对，具备该APP的全部权限，需要妥善保管。如果发生泄漏，您可以在API网关的控制台进行重置。3.您可以拥有多个APP，可以根据您的业务需求分别被授权不同的API。注意，API的授权对象是APP而不是阿里云用户账号。4.您可以在API网关控制台完成对APP的创建、修改、删除、查看详情、密钥管理、查看已授权等管理操作。授权授权，是指授予APP调用某个API的权限。您的APP需要获得API的授权才能调用该API。在公测阶段，由API服务方建立APP和API

7、之间的权限关系。1.在公测阶段，由提供API的服务方来建立授权关系，您需要向其提供AppID或者您的阿里云邮箱账户，说明给予某一个APP进行授权。授权建立后，您就可以使用该APP调用API了。2.在公测阶段，您不具备建立或者删除授权的权限。您仅可以在控制台查看相应APP下已经被授权的API。如果您需要解除某个API的授权，请您联系API服务提供方。加密签名您调用API时，需要使用AppKey和AppSecret计算加密签名，完成身份验证。5API网关/使用手册（调用API）1.在API网关，使用APP作为您调用API的身份。APP创建时，系统

8、会自动分配AppKey和AppSecret。服务器端会通过验证AppKey和AppSecret来完成请求者的身份验证。2.无论使用HTTP还是HTTPS协议提交请求