API资产：JSON数据导入功能详解及操作教程
API资产：JSON数据导入功能详解
什么是JSON数据？
官方解释
JSON 是一种用于存储和传输结构化信息的格式，主要应用于服务器与客户端之间的数据交换。JSON通常以字符串或对象的形式出现在扩展名为 .json 的文件中。
JSON数据结构
由于JSON基于JavaScript对象文字语法，因此两者有很多相似之处。 核心元素包括：
- 数据以
key/value对的形式呈现。 key与value用英文冒号分隔。- 数据元素用英文逗号分隔。
- 花括号
{}表示对象。 - 方括号
[]表示数组。
示例：
// 普通JSON数据格式
{"key1":"value1","key2":"value2","key3":"value3"}
// 对象嵌套数组
{"key1":"value1","key2":"value2","key3":["value3","value4","value5"]}
// 数组嵌套对象
[{"key1":"value1","key2":"value2"},{"key3":"value3","key4":"value4"}]在线JSON工具
功能介绍
在轻易云数据集成平台中，API资产非常重要。如果API资产没有维护好，每次使用同一个API时都需要从零开始配置，非常耗时且容易出错。因此，开发了此功能来加快API资产的维护工作。
在开放的API文档中，几乎都会提供一个成功请求的JSON示例。过去我们需要根据字段一个个添加，但现在可以直接将JSON数据转为API资产中的请求参数，大大提高了效率。
操作教程
获取JSON数据
首先需要获取一段格式正确的JSON数据。
注： 如何判断JSON数据格式是否正确，可以使用 上文提到的校验工具。通常，我们可以从API文档中获取到这些数据。这里以管易ERP的开放API为例进行讲解。
导入JSON数据
新建一个API资产或打开现成的，找到“导入 JSON”按钮，将获取到的数据粘贴进去，然后点击确定，就可以看到这些参数已经转为请求参数了。
注： 在前言部分提到过，键值对形式的数据在导入过程中会将键转为请求参数中的字段，而值则成为默认值。
分录子集导入
该功能不仅支持多维导入，还支持分录子集导入。选中需要导入子集的字段后点击“导入 JSON”，即可将其导入到选中字段的子集中。
注： 分录子集导入功能仅支持字段类型为多行分录或者子表对象，不支持多字段同时导入。