OpenAPI speccy lint tool, «Схема спецификации недействительна». - PullRequest
0 голосов
/ 24 августа 2018

Использование OpenApi speccy V0.8.1.Инструмент будет отображать веб-сайт, но не будет привязанНиже приведен пример с hello world, который не будет пухом.

{
    "openapi": "3.0",
    "info": {
        "title": "Hello",
        "version": "1.0.1"
    },
    "paths": {
        "/hello_query": {
            "get": {
                "description": "Hello query",
                "operationId": "hello_query",
                "responses": {
                    "200":  {
                        "description": "search results matching criteria",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "array",
                                    "items": {
                                        "type": "string"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}

1 Ответ

0 голосов
/ 24 августа 2018

В отличие от "swagger": "2.0", для поля openapi OpenAPI 3.0 требуется 3-значный номер версии :

"openapi": "3.0.0"

или

"openapi": "3.0.1"
...