添加数栈API

本文档介绍在EasyV中添加数栈API数据源的方法，以及相关参数配置说明。

API指通用的数据接口，如果您已有可用的API接口，可在EasyV中使用自己的API数据源连接。

查看文档：添加API数据源

添加数栈API为数据源为AK/SK签名加密方式，下面进行详细介绍。

一、AK/SK签名加密方式

1、创建数据源

使用AK/SK方式调用接口时类型需要选择使用“数栈API”，并填写数据源名称与描述。

Base URL

Base URL获取方式：在API管理-->我的API-->API申请 中可以查看到“调用URL地址”。

AppKey&AppSecret

AppKey&AppSecret获取方式，在API管理-->我的API-->API调用 中可以查看到“加密签名身份认证方式AppKey和AppSecret信息”。

2、配置接口

以一个简单的标题组件接入数栈API为例。

• 数据源类型：选择“数栈API”。
• 数据源：在对应数据源类型下选择创建的数据源。
• 请求方式：支持GET和POST两种。（推荐使用POST）

3、请求头&Body

在创建数据源时还需要设置JSON格式的数据源请求头与Body。

请求头

在API管理-->我的API-->API申请 中可以查看到"APP ID"。以JSON格式写入请求头中，如下为示例格式。

{
	"X-Auth-ActionId": "5379"
}

Body

在API管理-->我的API-->API申请 中可以查看到"Body"。以JSON格式写入Body中，如下为示例格式。

"order_id"字段是

{
    
"inFields": {
    
    
"order_id": 1
    
}
}

4、接入数据

首先调用接口查看接口返回数据格式。

打开API市场-->数据预览，在“输入参数”页面输入参数值，本示例接口在输入“1”后返回"data"字段内数据。

当接口与平台间存在跨域问题时，在EasyV内请求接口需要勾选上后端发起请求。

在EasyV内接收到的数据如下所示：

5、过滤数据

在拿到数据后，还需要将数据与组件的字段进行匹配才能显示数据，需要使用数据过滤器过滤接口中多余的数据。

如下数据过滤器所示过滤出数据的"data"字段中"order_amount"值。

示例数据过滤器：

return [{
  text: data[0].data[0].order_amount
}];

二、错误排查

当组件获取不到数据时，需要打开预览查看数据响应结果，在预览中打开浏览器开发者模式。

当数据为后端发起请求时可根据在项目编辑页面查看到的组件ID筛选数据响应。