[{"id":"bcb0874d-299b-448e-9552-9e9b25ef80dd","tags":[{"product":null,"links":null,"id":"ba7e818e-4f6b-4211-b1ac-58e3bafcf439","name":"\u66F4\u65B0","color":"orange","productId":"0995490e-43fc-4d6e-bc8d-8e66f38b0c63"}]},{"id":"8ce3627e-9e58-471b-9133-4f135d191e7b","tags":[{"product":null,"links":null,"id":"adf72f47-7f61-4239-8392-b9bcc127fa80","name":"\u65B0\u589E","color":"green","productId":"0995490e-43fc-4d6e-bc8d-8e66f38b0c63"}]},{"id":"ae60ae59-34f5-4f32-a8eb-243ed1457543","tags":[{"product":null,"links":null,"id":"adf72f47-7f61-4239-8392-b9bcc127fa80","name":"\u65B0\u589E","color":"green","productId":"0995490e-43fc-4d6e-bc8d-8e66f38b0c63"}]},{"id":"3d4848c3-910f-4ffa-9153-60bb507334a9","tags":[{"product":null,"links":null,"id":"adf72f47-7f61-4239-8392-b9bcc127fa80","name":"\u65B0\u589E","color":"green","productId":"0995490e-43fc-4d6e-bc8d-8e66f38b0c63"}]},{"id":"133f4ca6-d951-4d65-a618-3dc6301266f7","tags":[{"product":null,"links":null,"id":"adf72f47-7f61-4239-8392-b9bcc127fa80","name":"\u65B0\u589E","color":"green","productId":"0995490e-43fc-4d6e-bc8d-8e66f38b0c63"}]},{"id":"de62ec1c-813e-40b1-8160-a4cd109afe64","tags":[{"product":null,"links":null,"id":"adf72f47-7f61-4239-8392-b9bcc127fa80","name":"\u65B0\u589E","color":"green","productId":"0995490e-43fc-4d6e-bc8d-8e66f38b0c63"}]},{"id":"2426c71d-8332-4cbd-a436-1ec4f8666464","tags":[{"product":null,"links":null,"id":"adf72f47-7f61-4239-8392-b9bcc127fa80","name":"\u65B0\u589E","color":"green","productId":"0995490e-43fc-4d6e-bc8d-8e66f38b0c63"}]},{"id":"2ce7b6b0-78aa-4e4b-bf8a-e4ba2f988298","tags":[{"product":null,"links":null,"id":"adf72f47-7f61-4239-8392-b9bcc127fa80","name":"\u65B0\u589E","color":"green","productId":"0995490e-43fc-4d6e-bc8d-8e66f38b0c63"}]},{"id":"4706db46-0811-4652-8f59-1e0a1da84758","tags":[{"product":null,"links":null,"id":"adf72f47-7f61-4239-8392-b9bcc127fa80","name":"\u65B0\u589E","color":"green","productId":"0995490e-43fc-4d6e-bc8d-8e66f38b0c63"}]},{"id":"8f1271bb-2cd9-4f39-9897-c15b239ee7ab","tags":[{"product":null,"links":null,"id":"adf72f47-7f61-4239-8392-b9bcc127fa80","name":"\u65B0\u589E","color":"green","productId":"0995490e-43fc-4d6e-bc8d-8e66f38b0c63"}]},{"id":"677e13a7-6f3e-449f-986c-2c3a26f8d54f","tags":[{"product":null,"links":null,"id":"adf72f47-7f61-4239-8392-b9bcc127fa80","name":"\u65B0\u589E","color":"green","productId":"0995490e-43fc-4d6e-bc8d-8e66f38b0c63"}]},{"id":"5e40f6dc-caec-49d7-a1d0-be65f06815ba","tags":[{"product":null,"links":null,"id":"adf72f47-7f61-4239-8392-b9bcc127fa80","name":"\u65B0\u589E","color":"green","productId":"0995490e-43fc-4d6e-bc8d-8e66f38b0c63"}]},{"id":"2457f0e0-9e71-4860-a87d-065e0fb84f84","tags":[{"product":null,"links":null,"id":"adf72f47-7f61-4239-8392-b9bcc127fa80","name":"\u65B0\u589E","color":"green","productId":"0995490e-43fc-4d6e-bc8d-8e66f38b0c63"}]},{"id":"d5c67fd0-1145-482c-9113-97b492c44c18","tags":[{"product":null,"links":null,"id":"adf72f47-7f61-4239-8392-b9bcc127fa80","name":"\u65B0\u589E","color":"green","productId":"0995490e-43fc-4d6e-bc8d-8e66f38b0c63"}]},{"id":"a609a8fa-ab91-4c1d-a1c3-d209d0463303","tags":[{"product":null,"links":null,"id":"adf72f47-7f61-4239-8392-b9bcc127fa80","name":"\u65B0\u589E","color":"green","productId":"0995490e-43fc-4d6e-bc8d-8e66f38b0c63"}]},{"id":"b4a9eb15-94e5-48df-b218-a24138f0cf9c","tags":[{"product":null,"links":null,"id":"adf72f47-7f61-4239-8392-b9bcc127fa80","name":"\u65B0\u589E","color":"green","productId":"0995490e-43fc-4d6e-bc8d-8e66f38b0c63"}]}]
本文主要是基于前文内容,为您提供一些常见场景的举例说明。
阅读本文前,建议阅读网络型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"]
。