Part 01
什么是JSON Schema?
JSON Schema是一种用于描述和验证JSON数据结构的规范。它提供了一种结构化的方式来定义JSON数据的期望结构、类型、格式、约束条件等,通过JSON Schema我们可以确保接收到的JSON数据符合预期的规范,并对其进行有效性验证。
以下是一个简短的JSON Schema示例:
Part 02
JSON Schema常见关键字及说明
JSON Schema提供了一系列关键字用于描述和验证JSON数据的结构和约束条件。以下是一些常见的JSON Schema关键字及其说明:
通过使用这些关键字,我们可以定义出符合预期的数据结构,以及对数据进行有效性验证和约束条件的检查。在接口测试中,合理应用这些关键字可以提高测试的准确性和可靠性,确保接口返回的数据符合预期要求。
Part 03
JSON Schema在接口测试中的应用
Postman是一款功能强大且常见的接口测试工具,它提供了许多功能和特性,下面将介绍在Postman中如何应用JSON Schema进行接口测试。
1)定义JSON Schema: 在开始接口测试之前,首先需要定义JSON Schema来描述接口返回数据的结构和约束条件。可以使用任何文本编辑器创建一个JSON文件,并根据接口的要求定义JSON Schema。
上面的这个JSON Schema定义了一个对象,该对象包含三个属性:age、name和email。每个属性都有特定的类型和约束条件。
- age 属性是一个数字类型,且必须大于等于0。
- name 属性是一个字符串类型。
- email 属性是一个字符串类型,并且应符合电子邮件的格式。
此外,该JSON Schema使用required关键字指定了必填属性,即age、name和email都是必需的属性,缺少任何一个将导致验证失败。
2)创建请求: 打开Postman并创建一个新的请求,输入请求的URL、请求方法和其他必要的参数。确保选择正确的请求方法(GET、POST、PUT等)以及正确的URL。
3)添加测试脚本:在请求中选择"Tests"选项卡,并在其中添加JavaScript代码作为测试脚本。测试脚本将用于验证接口返回的数据是否符合JSON Schema定义。
在这里我们使用pm.response.json()方法获取接口返回的JSON数据,并将其与预定义的JSON Schema进行比较。使用tv4.validate()方法验证jsonData是否符合schema定义。如果数据与Schema匹配,断言将返回true。
4)发送请求和运行测试:现在,可以点击发送请求并在响应中运行测试脚本。测试脚本将验证接口返回的数据是否符合JSON Schema定义,并根据结果反馈相应的测试结果。
通过在Postman中使用JSON Schema进行接口测试,我们可以方便地验证接口返回的数据是否符合预期,验证接口返回数据的完整性、类型、格式等方面是否正确,有效的保证了数据传递和交互的准确性和一致性。
此外,除了日常的接口测试中可以使用JSON Schema外,我们还在自动化测试中使用,各种语言都有开源的第三方JSON Schema校验库,例如Go语言的gojsonschema,Python的jsonschema等。