接口出参

出参配置

出参的配置项说明如下。

Body : JSON类型

JSON格式解析支持两种类型的返回信息：application/json和text/json。

PTS目前支持新旧版本两种JSONPath的写法，为了说明新版与旧版JSONPath之间的区别，下面分别给出两者的使用示例。

建议您使用新版JSONPath写法。

JSONPath表达式（新版）

以此处提供的JSON示例为例，您可以在下方表格中查看新版JSONPath的语法及说明。

{
    "menu":{
        "header":"SVG Viewer",
        "items":[
            {
                "id":0
            },
            {
                "id":1,
                "label":"Open New"
            },
            null,
            {
                "id":2,
                "label":"Zoom In"
            },
            {
                "id":3,
                "label":"Zoom Out"
            },
            {
                "id":4,
                "label":"Original View"
            },
            null,
            {
                "id":5
            },
            {
                "id":6
            },
            {
                "id":7
            },
            null,
            {
                "id":8,
                "label":"Find..."
            },
            {
                "id":9,
                "label":"Find Again"
            },
            {
                "id":10
            },
            {
                "id":11,
                "label":"Copy Again"
            },
            {
                "id":12,
                "label":"Copy SVG"
            },
            {
                "id":13,
                "label":"View SVG"
            },
            {
                "id":14,
                "label":"View Source"
            },
            {
                "id":15,
                "label":"Save As"
            },
            null,
            {
                "id":16
            },
            {
                "id":17,
                "label":"About Adobe CVG Viewer..."
            }
        ]
    }
}

JSONPath表达式（旧版）

以此处提供的JSON示例为例，您可以在下方表格中查看旧版JSONPath的语法及说明。

{
    "info": "success",
    "message": "处理成功",
    "data": {
        "id":13509, "code":0,
        "items": [
            {"name": "name1", "value": "1234"},
            {"name": "name2", "value": "8448"},
            {"name": "name3", "value": "1298"},
            {"name": "name4", "value": "3049"},
            {"name": "name5", "value": "7648"}
        ]
    }
}
            

Body : TEXT类型

TEXT格式解析支持任意文本格式且可使用正则表达式提取。当一个正则表达式有多个匹配项时，可指定第几个匹配项，默认用0表示匹配第一个。

API的Response示例如下：

<input name="id" value="34729XXXX">
<input name="token" value="acdfo4dfopasdf44dXXXX">
...
<script>
    var planId=4587;
    var planId=5689;
    var planId=8906;
</script>
            

格式规范：

• 顺序匹配原则：按照顺序匹配出参信息。一旦匹配到之后即赋予该出参变量值，不会再匹配后续的信息，故需保证解析表达式的唯一性（除非多个中选第一个即可）。

• 被匹配的文本内容不能包含大括号（{}）、小括号（()）等特殊字符。

• 使用正则表达式提取JSON类型的Response时，无需在K/V间隔的冒号后面加空格（JSON格式化展现中加入空格是为了展现优化）。可查看Response原文信息，参考下图：

  

Cookie : K/V和Header : K/V类型

Cookie : K/V和Header : K/V分别用于提取Cookie字段和Header字段，解析表达式中直接写需要提取的Key即可。例如，Cookie信息为token=1234;path=/，需要提取Token的值，则解析表达式直接填写token即可。

响应状态码类型

响应状态码支持提取请求的状态码，一般情况下用于检查点或者条件跳转（不同状态码返回不同页面信息）。

出参调试

若您不能判断解析表达式是否正确时，可以在场景调试中测试解析表达式并设置出参。操作步骤如下：

1. 单击创建PTS场景页面下方的调试场景，然后在弹出的场景调试对话框中单击场景名称，对话框右侧将显示详细信息，在右侧对话框中，选中某条API，单击点此去测试出参正则表达式。
2. 在弹出的对话框，选择来源格式，填写正则表达式，指定为第几个匹配项，填写出参参数名，单击测试表达式。通过响应详情匹配结果，预判提取的内容是否符合预期。
3. 若需重新设置出参，则单击同步出参配置，将此正则表达式同步到该API的出参列表中。
   说明 场景调试结束后，如有同步的出参，需返回压测场景配置页签，在对应的API出参定义页签下，设置出参名。

出参示例

在理财业务中，需要根据用户的消费能力，推荐适当产品。则需要在前置接口中提取出消费能力等级作为出参，在当前的产品推荐接口中，使用该出参。

操作步骤如下：

1. 登录PTS控制台，在左侧导航栏选择性能测试 > 创建场景，然后单击PTS压测。

2. 在创建PTS场景页面，添加消费能力（含出参）和产品推荐API，并填写对应的URL。
3. 在消费能力（含出参）API中，基于请求的响应详情，提取消费能力信息作为出参。填写出参名（如output）和具体的解析表达式（如data.items[0].value）。
4. 单击创建PTS场景页面左下角的参数列表，在弹出的自定义参数页签可查看已创建的出参。单击出参参数名称（如output）或图标，系统将自动复制参数内容。
5. 在产品推荐API的Body中带入已提取的出参，在Body定义编辑框内，粘贴参数内容。

   此外，您也可以对Body内容进行编辑，如组合字符串、参数或函数等。