[]
本文主要是基于前文内容,为您提供一些常见场景的举例说明。
阅读本文前,建议阅读网络型JSON数据源章节下的连接网络型JSON、连接网络型JSON时使用参数两部分,
同时,本文部分章节涉及HTTP协议相关内容,建议您提前了解。
这个部分主要介绍网络型JSON数据源中POST请求的配置以及多值参数在POST请求中的使用。
创建一个网络型JSON数据源,进入网络型JSON数据源的编辑页面

创建一个端点地址
配置名称和请求URL

配置请求方法以及有效载荷

配置预查询

验证与预览

创建一个网络型JSON数据源,进入网络型JSON数据源的编辑页面
创建一个基准地址

创建一个端点地址
配置名称,选择基准地址并请求URL

配置请求方法,有效载荷以及预查询

验证与预览

创建另一个端点地址
我们可以通过复制的方式创建新的端点地址,也可以新建一个全新的端点地址,在这里我们用复制的方式来创建新的端点地址。

修改名称,请求方法,有效载荷和预查询

验证与预览

首先,对于POST请求和GET请求而言,多值参数在请求地址中使用的方式和作用是一样。
使用方式:多值参数在请求API地址中仅限于查询字符串部分使用
参数作用:
当分隔符未设置时,多值参数的各个值会被拆分为查询字符串键的多个值,并使用&符号拼接。
当分隔符设置为别的符号时,多值参数的各个值直接使用该符号进行拼接,并作为查询字符串键的值替换到请求地址中。
下面以GET请求作为例子,介绍请求地址中如何使用多值参数
创建一个网络型JSON数据源,进入网络型JSON数据源的编辑页面
创建一个端点地址

在端点地址中定义多值参数
新建多值数据源参数
配置参数默认值和分隔符

对于新建的参数username,默认值中包含两个用户名Bret和Antonette,多个值之间用逗号隔开;同时,我们并没有为参数username设置任何分隔符。
使用数据源参数
编辑端点地址
在请求URL中使用参数

验证与预览


可以看到端点地址数据中仅筛选出用户名为Bret和Samantha的两条数据,多值参数生效。
预览请求

从上图中我们可以看到,参数username的两个值被拆分到查询字符串的值上,并使用&符号对两个查询字符串进行拼接得到了最终的字符串。
端点地址的API地址查询字符串部分?username=@username,参数username的默认值为Bret,Antonette,最终被替换成?username=Bret&username=Antonette。
相同地,如果将参数username的分隔符设置成符号+,端点地址的API地址查询字符串部分username=@username,最终将会被替换成?username=Bret%20Antonette,其中的%20是符号+编码以后的结果,您可以自行尝试。
是否要设置分隔符,分隔符设置成什么,取决于要连接的请求接受多值查询字符串的规定。
多值参数除了用于请求地址的查询字符串部分,还可以用于请求头和有效载荷中。此时,多值参数的参数值会被拼成一个数组来进行使用。
多值参数在请求头和有效载荷中的行为是一致的,以下以有效载荷进行举例说明。
编辑上一个例子中创建的网络型JSON数据源
创建一个新的端点地址

从上图中可以看到,端点地址的有效载荷部分,我们一开始设置成了
{
"shirtSize": ["M", "L"]
}通过衬衫尺寸对用户进行筛选。
在端点地址中定义多值参数
新建多值数据源参数
配置参数默认值和分隔符

对于参数username,默认值设置为M和L,两个值用逗号分隔。该参数将用于有效载荷中,分隔符对于用于请求头和有效载荷中的多值参数没有作用。
使用数据源参数
编辑端点地址
在请求有效载荷中使用参数

在请求载荷中将原有的["M", "L"]替换成参数@shirtSize。
验证与预览


从上图中可以看到,预览数据中已经筛选出衬衫尺寸为M和L的用户,多值参数shirtSize生效。
预览请求

从上图中可以看到,字符串类型的多值参数shirtSize的默认值M,L被拼接成一个包含"M"和"L"的数组["M","L"]。