章节目录：

REST 客户端是检查 RESTful 服务功能的工具。可将 REST 客户端添加到您的场景中，并配置它们以满足您的测试需求。还可以创建并运行一个作业来执行相关的测试场景并提供适当的环境。使用这些测试来检查特定组件的健康状况，并在供应期间进行自动化测试。

CTP 中的 REST 客户端接口设计用于快速创建新的 REST 客户端工具。使用 SOAtest 桌面创建具有更复杂配置的更高级 REST 客户端，例如由自定义脚本定义的消息有效负载。 请参阅REST 客户端。

添加 REST 客户端

1. 在左窗格中，选择要添加新 REST 客户端的 .tst 或测试套件。
2. 从页面级操作菜单选择添加 REST 客户端。
    
3. （可选）修改新建工具的名称。
4. 按如下所述配置工具并点击保存。

新工具将被添加到所选测试套件的末尾。

配置 REST 客户端

1. (可选）您可以在工作项字段中将客户端与需求、任务或其他工作项关联起来。详情请参阅关联测试与工作项。 
2. 如果包含的测试套件包含多个数据源，则可以检查和更改用于参数化此 REST 客户端的数据源。详情请参阅使用数据源和数据库值参数化。
    
3. 从方法下拉菜单中选择要执行的 HTTP 方法。

4. 指定用于访问资源的 URL（包括查询）。 

   提示：使用 {var_name}

   如果您熟悉 SOAtest，您可以使用标准的 ${var_name} 符号来引用为测试场景定义的环境变量、测试套件变量和数据源值。这适用于 URL 和有效负载。

   注意，当使用 JSON 时，一个特殊的符号用于参数化 JSON 消息中的数字或布尔字段：${Number:<value>} 或 ${boolean:<value>}。例如，若要使用 Count 列参数化 number 字段，则可以使用 ${number:Count}。

5. （可选）可以自定义客户端，以便它成功地处理了 2xx 范围之外的 HTTP 响应码。在有效响应字段中指定单个代码并/或以逗号分隔的列表形式指定代码范围。例如，如果使用 "302, 500-599"，则将接受 302 码或 5xx 范围内的任何码。  如果正在使用参数化值，则请保证数据源中的值使用与之相同的格式（如，"302, 500-599"）。
6. （可选）如果客户端未收到响应，则指定客户端超时之前的时间长度（毫秒）。
    

7. （可选）如果服务需要身份验证，则激活启用 HTTP 身份验证选项并指定登录凭据。
    

8. （可选）如果想覆盖默认头部，请添加 HTTP 头。更多信息，请参阅 HTTP 头。 从 HTTP 头下拉菜单中选择字面量或表格以在文本区域中输入值，或使用表格格式生成头部。 

   字面量模式

   

   表格模式

   

9. （可选）如果要在发送请求前重置 Cookie，请启用在发送请求前重置现有的 cookie选项。
10. 如果选择了一个发送数据的方法（例如，PUT、POST），那么使用有效负载控件为将要发送的消息指定有效负载。
    
    1. 确保选择合适的有效负载格式和媒体类型（在格式和内容类型框中）。
    2. 在文本编辑器、JSON 编辑器或 XML 编辑器中指定有效负载（请参阅编辑 JSON 消息和编辑 XML 消息以获得详细信息和提示）。