Add schema validation sectio

docs/conf.py

@@ -26,7 +26,7 @@
 # The short X.Y version
 version = u''
 # The full version, including alpha/beta/rc tags
-release = u'Version 1.4.1 - October 2019'
+release = u'Version 1.5.0 - December 2019'
 
 
 # -- General configuration ---------------------------------------------------

docs/index.rst

@@ -31,6 +31,7 @@ Simple solutions to common problems
 
    request-creation
    assertions
+   schema-validation
    libraries
    workflows
    newman

docs/schema-validation.rst

@@ -0,0 +1,70 @@
+*****************
+Schema validation
+*****************
+
+This section contains different examples of validating JSON responses using the Ajv schema validator. I do not recommend using the tv4 (Tiny Validator for JSON Schema v4).
+
+Response is an object
+---------------------
+
+This is the JSON response: ::
+
+    {}
+
+This is the JSON schema: ::
+
+    const schema = {
+        "type": "object",
+    };
+
+And here is the test: ::
+
+    pm.test("Validate schema", () => {
+        pm.response.to.have.jsonSchema(schema);
+    });
+
+
+Object has optional property
+----------------------------
+
+This is the JSON response: ::
+
+    {
+        "code": "FX002"
+    }
+
+This is the JSON schema with a property named code of type String: ::
+
+    const schema = {
+        "type": "object",
+        "properties": {
+            "code": { "type": "string" }
+        }
+    };
+
+Possible types are:
+    - integer
+    - number
+    - boolean
+    - null
+    - Object
+    - array
+
+Object has required property
+----------------------------
+
+This is the JSON response: ::
+
+    {
+        "code": "FX002"
+    }
+
+This is the JSON schema with a property named code of type String that is mandatory: ::
+
+    const schema = {
+        "type": "object",
+        "properties": {
+            "code": { "type": "string" }
+        },
+        "required": ["code"]
+    };