
# 新建API数据连接
使用API数据源，您可以通过调用一个第三方的REST（Representational State Transfer）API获取源数据，该REST API响应结果中的HTTP body体就是源数据，DLV可以解析响应结果中的源数据并将其直接展示在大屏上。您无需创建数据连接，可以直接在大屏编辑页面的数据面板中配置API数据源的URL。
#### 使用限制
连接API数据源，需要满足以下条件：
- 获取源数据的REST API和华为云网络之间能够正常通信。
- 获取源数据的REST API当前仅支持通过HTTPS协议的GET请求调用，且API响应结果的HTTP body体仅支持JSON格式。
- DLV的API数据源仅支持解析与静态数据源的JSON结构相似的一级JSON数组，不支持多层嵌套的 JSON结构。
 
 #### 使用API数据源
1. 登录DLV控制台，单击"我的大屏"。
2. 在"我的大屏"页面，找到需要编辑的大屏，将鼠标移至该大屏图标上，然后单击编辑按钮![](https://support.huaweicloud.com/usermanual-dlv/zh-cn_image_0220178078.png)进入大屏开发页面。
   
   图1编辑大屏   
   ![](https://support.huaweicloud.com/usermanual-dlv/zh-cn_image_0000001084798981.png "点击放大")
   
   
3. 从左侧组件库中选择一个组件，例如"柱状图"，该组件将出现在画布中。单击该组件，再单击屏幕右侧的"数据"面板。
4. 在"数据"面板中，设置"数据源类型"为"API"。
5. 在编辑区域中输入完整的URL地址。 
   当"由服务器发起请求（仅支持HTTPS）"设为关闭时，由DLV页面直接发送Ajax请求访问URL。这种使用方式存在跨域问题。
   当"由服务器发起请求（仅支持HTTPS）"设为开启时，由DLV的后台服务器代理转发URL请求并返回数据。这种使用方式可以解决跨域问题。
   ![](https://support.huaweicloud.com/usermanual-dlv/public_sys-resources/note_3.0-zh-cn.png)
   DLV当前只支持HTTPS协议，请确保您发送的是HTTPS的API请求。
   图2新建API数据源   
   ![](https://support.huaweicloud.com/usermanual-dlv/zh-cn_image_0000001086763139.png)
   
   
6. 单击" 预览结果"，数据响应成功后可查看结果。 
   图3查看数据响应结果   
   ![](https://support.huaweicloud.com/usermanual-dlv/zh-cn_image_0000001087006203.png "点击放大")
   
   
7. 根据响应数据的属性名称配置字段映射。 
   图4配置映射关系   
   ![](https://support.huaweicloud.com/usermanual-dlv/zh-cn_image_0000001087319727.png)
   
   
8. 配置完成后的大屏组件效果如下图所示。 
   图5大屏效果图   
   ![](https://support.huaweicloud.com/usermanual-dlv/zh-cn_image_0000001087006573.png "点击放大")
   
   
 
