Project: KICS (Provisioning / Security & Compliance)
File: a8e859da-4a43-4e7f-94b8-25d6e3bf8e90.md

title: Items Undefined (v3) hide: toc: true navigation: true <style> .highlight .hll { background-color: #ff171742; } .md-content { max-width: 1100px; margin: 0 auto; } </style> Query id: a8e859da-4a43-4e7f-94b8-25d6e3bf8e90 Query name: Items Undefined (v3) Platform: OpenAPI Severity: <span style="color:#5bc0de">Info</span> Category: Structure and Semantics URL: Schema/Parameter items should be defined when the schema/parameter is set to an array.<br> ```json title="Positive test num. 1 - json file" hl_lines="50" { "openapi": "3.0.0", "info": { "title": "Simple API Overview", "version": "1.0.0", "contact": { "name": "contact", "url": "https://www.google.com/", "email": "user@gmail.c" } }, "paths": { "/": { "get": { "operationId": "listVersionsv2", "summary": "List API versions", "responses": { "200": { "description": "200 response", "content": { "application/json": { "examples": { "foo": { "value": { "versions": [ { "status": "CURRENT", "updated": "2011-01-21T11:33:21Z", "id": "v2.0", "links": [ { "href": "http://127.0.0.1:8774/v2/", "rel": "self" } ] } ] } } } } } } } } } }, "components": { "schemas": { "GeneralError": { "type": "array", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" } }, "required": [ "name" ] } } } } ``` ```json title="Positive test num. 2 - json file" hl_lines="22" { "openapi": "3.0.0", "info": { "title": "Simple API Overview", "version": "1.0.0", "contact": { "name": "contact", "url": "https://www.google.com/", "email": "user@gmail.c" } }, "paths": { "/": { "get": { "operationId": "listVersionsv2", "summary": "List API versions", "responses": { "200": { "description": "200 response", "content": { "application/json": { "schema": { "type": "array", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" } } }, "examples": { "foo": { "value": { "versions": [ { "status": "CURRENT", "updated": "2011-01-21T11:33:21Z", "id": "v2.0", "links": [ { "href": "http://127.0.0.1:8774/v2/", "rel": "self" } ] } ] } } } } } } } } } } } ``` ```yaml title="Positive test num. 3 - yaml file" hl_lines="27" openapi: 3.0.0 info: title: Simple API Overview version: 1.0.0 paths: "/": get: operationId: listVersionsv2 summary: List API versions responses: "200": description: 200 response content: application/json: examples: foo: value: versions: status: CURRENT updated: "2011-01-21T11:33:21Z" id: v2.0 links: href: http://127.0.0.1:8774/v2/ rel: self components: schemas: GeneralError: type: array properties: code: type: string format: int32 message: type: string required: name ``` <details><summary>Positive test num. 4 - yaml file</summary> ```yaml hl_lines="15" openapi: 3.0.0 info: title: Simple API Overview version: 1.0.0 paths: "/": get: operationId: listVersionsv2 summary: List API versions responses: "200": description: 200 response content: application/json: schema: type: array properties: code: type: string format: int32 message: type: string examples: foo: value: versions: status: CURRENT updated: "2011-01-21T11:33:21Z" id: v2.0 links: href: http://127.0.0.1:8774/v2/ rel: self ``` </details> <details><summary>Positive test num. 5 - json file</summary> ```json hl_lines="19" { "swagger": "2.0", "info": { "version": "1.0", "title": "Example", "description": "A sample API specification" }, "paths": { "/users": { "get": { "description": "Returns all users from database", "operationId": "findUsers", "produces": [ "application/json" ], "responses": { "200": { "description": "users response", "schema": { "type": "array" } } } } } }, "definitions": { "User": { "type": "object", "required": [ "id", "name" ], "properties": { "id": { "type": "integer", "format": "int64" }, "name": { "type": "string" } } } } } ``` </details> <details><summary>Positive test num. 6 - yaml file</summary> ```yaml hl_lines="16" swagger: '2.0' info: version:

title: Example description: A sample API specification paths: "/users": get: description: Returns all users from database operationId: findUsers produces: application/json responses: '200': description: users response schema: type: array definitions: User: type: object required: id name properties: id: type: integer format: int64 name: type: string ``` </details> ```json title="Negative test num. 1 - json file" { "openapi": "3.0.0", "info": { "title": "Simple API Overview", "version": "1.0.0", "contact": { "name": "contact", "url": "https://www.google.com/", "email": "user@gmail.c" } }, "paths": { "/": { "get": { "operationId": "listVersionsv2", "summary": "List API versions", "responses": { "200": { "description": "200 response", "content": { "application/json": { "examples": { "foo": { "value": { "versions": [ { "status": "CURRENT", "updated": "2011-01-21T11:33:21Z", "id": "v2.0", "links": [ { "href": "http://127.0.0.1:8774/v2/", "rel": "self" } ] } ] } } } } } } } } } }, "components": { "schemas": { "GeneralError": { "type": "array", "items": { "type": "string" }, "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" } }, "required": [ "name" ] } } } } ``` ```json title="Negative test num. 2 - json file" { "openapi": "3.0.0", "info": { "title": "Simple API Overview", "version": "1.0.0", "contact": { "name": "contact", "url": "https://www.google.com/", "email": "user@gmail.c" } }, "paths": { "/": { "get": { "operationId": "listVersionsv2", "summary": "List API versions", "responses": { "200": { "description": "200 response", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "string" }, "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" } } }, "examples": { "foo": { "value": { "versions": [ { "status": "CURRENT", "updated": "2011-01-21T11:33:21Z", "id": "v2.0", "links": [ { "href": "http://127.0.0.1:8774/v2/", "rel": "self" } ] } ] } } } } } } } } } } } ``` ```yaml title="Negative test num. 3 - yaml file" openapi: 3.0.0 info: title: Simple API Overview version: 1.0.0 paths: "/": get: operationId: listVersionsv2 summary: List API versions responses: "200": description: 200 response content: application/json: examples: foo: value: versions: status: CURRENT updated: "2011-01-21T11:33:21Z" id: v2.0 links: href: http://127.0.0.1:8774/v2/ rel: self components: schemas: GeneralError: type: array items: type: string properties: code: type: string format: int32 message: type: string required: name ``` <details><summary>Negative test num. 4 - yaml file</summary> ```yaml openapi: 3.0.0 info: title: Simple API Overview version: 1.0.0 paths: "/": get: operationId: listVersionsv2 summary: List API versions responses: "200": description: 200 response content: application/json: schema: type: array items: type: string properties: code: type: string format: int32 message: type: string examples: foo: value: versions: status: CURRENT updated: "2011-01-21T11:33:21Z" id: v2.0 links: href: http://127.0.0.1:8774/v2/ rel: self ``` </details> <details><summary>Negative test num. 5 - json file</summary> ```json { "swagger": "2.0", "info": { "version": "1.0", "title": "Example", "description": "A sample API specification" }, "paths": { "/users": { "get": { "description": "Returns all users from database", "operationId": "findUsers", "produces": [ "application/json" ], "responses": { "200": { "description": "users response", "schema": { "type": "array", "items": { "$ref": "#/definitions/User" } } } } } } }, "definitions": { "User": { "type": "object", "required": [ "id", "name" ], "properties": { "id": { "type": "integer", "format": "int64" }, "name": { "type": "string" } } } } } ``` </details> <details><summary>Negative test num. 6 - yaml file</summary> ```yaml swagger: '2.0' info: version: '1.0' title: Example description: A sample API specification paths: "/users": get: description: Returns all users from database operationId: findUsers produces: application/json responses: '200': description: users response schema: type: array items: "$ref": "#/definitions/User" definitions: User: type: object required: id name properties: id: type: integer format: int64 name: type: string ``` </details>