Update JSON Schema Validator Documentation with 'additionalProperties' Configuration

Description: Response validation is not working correctly when using the following schema in the API definition.

schema:
    required:
        - Inventory
    type: object
    properties:
        Inventory:
            type: array
            items:
                type: object
                properties:
                    BusinessID:
                        type: string
                    CustomerID:
                        type: string
                    OrderQuantity:
                        type: number
                    LastOrderDate:
                        type: string
                    NextDeliveryDate:
                        type: string
                    IsDeliverable:
                        type: boolean
                    TotalPieces:
                        type: number
                    barcode:
                        type: string

The reason is that the following request is accepted by the API, even though there are some properties in the request that were not specified in the above schema.

{
    "Inventory": [
        {
            "BusinessID": "111AABB22",
            "CustomerID": "",
            "OrderQuantity": 0.0,
            "LastOrderDate": "",
            "NextDeliveryDate": "",
            "IsDeliverable": false,
            "TotalPieces": 10.0,
            "PiecesB2B": 10.0,
            "PiecesB2C": 0,
            "barcode": "1234567890"
        }
    ]
}

Solution is to use the above schema with 'additionalProperties: false' as follows, in order to prevent the acceptance of additional properties other than those specified in the schema.

schema:
    required:
        - Inventory
    type: object
    properties:
        Inventory:
            type: array
            items:
                type: object
                properties:
                    BusinessID:
                        type: string
                    CustomerID:
                        type: string
                    OrderQuantity:
                        type: number
                    LastOrderDate:
                        type: string
                    NextDeliveryDate:
                        type: string
                    IsDeliverable:
                        type: boolean
                    TotalPieces:
                        type: number
                    barcode:
                        type: string
                additionalProperties: false

Add 'additionalProperties' configuration in the documentation[1] along with a yaml format example, as this is a common requirement.

[1] https://apim.docs.wso2.com/en/4.1.0/design/api-security/api-request-response-schema-validation/json-schema-validator/#enabling-the-json-schema-validator

wso2 / docs-apim

Update JSON Schema Validator Documentation with 'additionalProperties' Configuration #7964