API资产—JSON数据导入功能详解

前言

什么是JSON数据？

一、官方解释

JSON是一种存储结构化信息的格式。它主要用于在服务器和客户端之间传输Web应用程序数据。JSON以字符串或对象的形式出现在扩展名为.json的文件中或在引号内，以其他文件格式分配给变量。

二、JSON数据结构

由于JSON结构基于JavaScript对象文字语法，因此它们有许多相似之处。

这些是JSON语法的核心元素：

• 数据以key/value对的形式呈现。
• key与value用英文冒号
• 数据元素用英文逗号分隔。
• 花括号{}确定对象。
• 方括号[]表示数组。

JSON数据如下所示：

//普通JSON数据格式
{
    "key1": "value1",
    "key2": "value2",
    "key3": "value3"
}
//对象嵌套数组
{
    "key1": "value1",
    "key2": "value2",
    "key3": [
        "value3",
        "value4",
        "value5"
    ]
}
//数组嵌套对象
[
    {
        "key1": "value1",
        "key2": "value2"
    },
    {
        "key3": "value3",
        "key4": "value4"
    }
]

三、在线JSON工具

1. JSON数据校验工具
2. JSON数据对比工具

功能介绍

在轻易云数据集成平台中最为重要的就是API资产，在过去的实施经验中发现，如果API资产没有维护好就会导致每次用到同一个API都要从零开始配置，这样非常耗费时间而且容易出错。这就越发突显出维护好API资产是迫在眉睫的事情。但是在维护API资产的过程中发现，有的API请求的时候字段非常的多，如果要一个一个去添加的话也是非常耗费时间的，所以为了加快API资产的维护工作故开发了此功能。

在各类开放的API文档中，几乎都会提供一个成功请求的JSON示例。在过往的操作中我们需要根据字段一个一个去添加，但是使用此功能，即可直接将JSON数据直接转成API资产中的请求参数，大大的提高了API资产的维护效率。

操作教程

一、获取JSON数据

首先我们需要获取到一段格式正确的JSON数据。

注：如何判断JSON数据格式是否正确可以使用上文提到的 JSON数据校验工具 。JSON数据我们一般可以从API文档中去获取到，在这里我们以管易ERP的开放API为例给大家讲解一下该功能是如何使用的。

二、导入JSON数据

新建一个API资产或打开一个现成的API资产，找到JSON导入按钮，将获取到的JSON数据粘贴到JSON文本框，然后点击确定，就可以看到JSON数据已经转为API资产中的请求参数了。

注：在前言部分介绍JSON数据的时候就已经提过JSON数据是键值对形式的，那么在导入过程中键的部分将转为请求参数中的字段，值的部分将转为默认值的部分。

三、分录子集导入

该功能不仅支持多维导入也支持分录子集导入。也就是选中需要导入子集的字段然后点击JSON导入将JSON数据导入到选中字段的子集中。

注：分录子集导入功能仅支持字段类型为多行分录或者子表对象的。该功能不支持多字段同时导入。