[{"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"}]}]
        
(Showing Draft Content)

场景举例-POST请求及多值参数的使用

本文主要是基于前文内容,为您提供一些常见场景的举例说明。

阅读本文前,建议阅读网络型JSON数据源章节下的连接网络型JSON连接网络型JSON时使用参数两部分,

同时,本文部分章节涉及HTTP协议相关内容,建议您提前了解。

POST请求及多值参数的使用

这个部分主要介绍网络型JSON数据源中POST请求的配置以及多值参数在POST请求中的使用。

单独使用端点地址配置POST请求

  1. 创建一个网络型JSON数据源,进入网络型JSON数据源的编辑页面

    create-web-json-datasource.png

  2. 创建一个端点地址

    1. 配置名称和请求URL

      配置名称和请求URL

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

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

    3. 配置预查询

      配置预查询

    4. 验证与预览

      验证与预览

同时使用基准地址和端点地址配置多个POST请求

  1. 创建一个网络型JSON数据源,进入网络型JSON数据源的编辑页面

  2. 创建一个基准地址

    创建基准地址

  3. 创建一个端点地址

    1. 配置名称,选择基准地址并请求URL

      创建端点地址

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

      创建端点地址

    3. 验证与预览

      验证与预览

  4. 创建另一个端点地址

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


    复制端点地址

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

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

    2. 验证与预览

      验证与预览

多值参数在请求地址上的应用

首先,对于POST请求和GET请求而言,多值参数在请求地址中使用的方式和作用是一样。

  • 使用方式:多值参数在请求API地址中仅限于查询字符串部分使用

  • 参数作用:

    • 当分隔符未设置时,多值参数的各个值会被拆分为查询字符串键的多个值,并使用&符号拼接。

    • 当分隔符设置为别的符号时,多值参数的各个值直接使用该符号进行拼接,并作为查询字符串键的值替换到请求地址中。

下面以GET请求作为例子,介绍请求地址中如何使用多值参数

  1. 创建一个网络型JSON数据源,进入网络型JSON数据源的编辑页面

  2. 创建一个端点地址

    创建端点地址

  3. 在端点地址中定义多值参数

    1. 新建多值数据源参数

    2. 配置参数默认值和分隔符

      配置多值参数

对于新建的参数username,默认值中包含两个用户名BretAntonette,多个值之间用逗号隔开;同时,我们并没有为参数username设置任何分隔符。

  1. 使用数据源参数

    1. 编辑端点地址

    2. 在请求URL中使用参数

      多值参数在请求URL中使用

  2. 验证与预览

    验证与预览

    预览数据

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

  3. 预览请求

    预览请求

    从上图中我们可以看到,参数username的两个值被拆分到查询字符串的值上,并使用&符号对两个查询字符串进行拼接得到了最终的字符串。

    端点地址的API地址查询字符串部分?username=@username,参数username的默认值为Bret,Antonette,最终被替换成?username=Bret&username=Antonette

    相同地,如果将参数username的分隔符设置成符号+,端点地址的API地址查询字符串部分username=@username,最终将会被替换成?username=Bret%20Antonette,其中的%20是符号+编码以后的结果,您可以自行尝试。

    是否要设置分隔符,分隔符设置成什么,取决于要连接的请求接受多值查询字符串的规定。

多值参数在请求头和有效载荷中的使用

多值参数除了用于请求地址的查询字符串部分,还可以用于请求头和有效载荷中。此时,多值参数的参数值会被拼成一个数组来进行使用。

多值参数在请求头和有效载荷中的行为是一致的,以下以有效载荷进行举例说明。

  1. 编辑上一个例子中创建的网络型JSON数据源

  2. 创建一个新的端点地址

    创建端点地址2

    从上图中可以看到,端点地址的有效载荷部分,我们一开始设置成了

    {
        "shirtSize": ["M", "L"]
    }

    通过衬衫尺寸对用户进行筛选。

  3. 在端点地址中定义多值参数

    1. 新建多值数据源参数

    2. 配置参数默认值和分隔符

      5-create-para

      对于参数username,默认值设置为ML,两个值用逗号分隔。该参数将用于有效载荷中,分隔符对于用于请求头和有效载荷中的多值参数没有作用。

  4. 使用数据源参数

    1. 编辑端点地址

    2. 在请求有效载荷中使用参数

      5-use-para

      在请求载荷中将原有的["M", "L"]替换成参数@shirtSize

  5. 验证与预览

    5-validate-and-preview.png

    5-preview-data

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

  6. 预览请求

    5-preview-request

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