本文以Postman工具为例，为您介绍如何调用数据服务生成的API。

前提条件

• 具备数据服务模块菜单权限及目标API的运行及以上权限。
• 目标API所属位置项目绑定资源组有运行中的数据服务实例。

步骤一：获取API信息

在发起接口调用（Postman调试）前，需先前往目标数据服务详情页面，完整收集以下关键配置项：

1. 支持协议（HTTP/HTTPS）；
2. 请求方式（GET/POST）；
3. API Path（接口路径）；
4. 参数清单：入参名称、参数位置（Header/Body）、字段类型、是否必填。

地址拼接规则

API完整调用地址由协议、域名及数据服务路径组成，API调用地址拼接规则如下：协议://域名/API path

• 协议：API协议为创建数据服务时定义支持的协议。
• 域名：通过API网关的分组管理，进入组名称详情页，查看默认域名或自定义域名。

• API path：API Path为创建数据服务时自定义配置的接口路径，可进入数据服务列表页面查看对应API Path值。

注意：API Path自带前置斜杠，拼接完整地址时不要重复添加斜杠，防止访问404。

示例

假设查询到域名为bigdata.agilecloud-nj.com，API path为/api/a，那么HTTP和HTTPS协议调用地址如下所示：

• HTTP：http://bigdata.agilecloud-nj.com/api/a；
• HTTPS：https://bigdata.agilecloud-nj.com/api/a。

注意：

• API处于未发布状态无法外部调用，必须单击发布后，外部系统才可访问；

步骤二：获取Authorization签名

数据服务API支持对外网络访问，为管控接口访问权限、避免匿名访问造成数据泄露，平台网关会对每一笔外部请求进行身份校验。调用方必须在请求Header中传入有效的鉴权凭证。具体获取签名步骤如下：

获取AK/SK

平台采用AK/SK加密签名鉴权机制，所有对外API请求都需要通过AK+SK共同计算生成合法Authorization签名，再放入请求Header完成身份校验，请参考获取AK/SK来获取。

获取签名

1. 登录签名计算工具，进入工具配置页面；

2. 依次录入两类必填配置信息：

   • HTTP请求信息：填入前文步骤一查询到的请求方式、API path、Host等信息；
   • 签名信息：填入上一步获取的AK、SK密钥对；
3. 确认所有参数填写无误后，单击一键计算按钮，工具在最下方自动生成标准Authorization签名串；
4. 复制生成完成的签名串，用于下方Postman工具调用时配置请求Header鉴权参数。

步骤三：调用API（以Postman调用为例）

1. 填写调用地址

将步骤一拼接完成的完整API调用地址，粘贴至Postman地址输入框，同时选择与接口匹配的请求方式（GET/POST）。

2. 配置鉴权Header

进入Headers标签页，新增一条鉴权请求头：

3. 录入业务入参发送并查看结果

根据步骤一查到的参数位置分别配置：

• Query参数：填写至Params标签；

• Body参数：切换至Body>raw，选择JSON格式，填写对应JSON请求体