| { |
| "openapi": "3.0", |
| "info": { |
| "version": "1.0.0", |
| "title": "OpenAPI Petstore", |
| "license": { |
| "name": "MIT" |
| } |
| }, |
| "servers": [ |
| { |
| "url": "https://petstore.openapis.org/v1", |
| "description": "Development server" |
| } |
| ], |
| "paths": { |
| "/pets": { |
| "get": { |
| "summary": "List all pets", |
| "operationId": "listPets", |
| "tags": [ |
| "pets" |
| ], |
| "parameters": [ |
| { |
| "name": "limit", |
| "in": "query", |
| "description": "How many items to return at one time (max 100)", |
| "required": false, |
| "schema": { |
| "type": "integer", |
| "format": "int32" |
| } |
| } |
| ], |
| "responses": { |
| "200": { |
| "description": "An paged array of pets", |
| "headers": { |
| "x-next": { |
| "schema": { |
| "type": "string" |
| }, |
| "description": "A link to the next page of responses" |
| } |
| }, |
| "content": { |
| "application/json": { |
| "schema": { |
| "$ref": "#/components/schemas/Pets" |
| } |
| } |
| } |
| }, |
| "default": { |
| "description": "unexpected error", |
| "content": { |
| "application/json": { |
| "schema": { |
| "$ref": "#/components/schemas/Error" |
| } |
| } |
| } |
| } |
| } |
| }, |
| "post": { |
| "summary": "Create a pet", |
| "operationId": "createPets", |
| "tags": [ |
| "pets" |
| ], |
| "responses": { |
| "201": { |
| "description": "Null response" |
| }, |
| "default": { |
| "description": "unexpected error", |
| "content": { |
| "application/json": { |
| "schema": { |
| "$ref": "#/components/schemas/Error" |
| } |
| } |
| } |
| } |
| } |
| } |
| }, |
| "/pets/{petId}": { |
| "get": { |
| "summary": "Info for a specific pet", |
| "operationId": "showPetById", |
| "tags": [ |
| "pets" |
| ], |
| "parameters": [ |
| { |
| "name": "petId", |
| "in": "path", |
| "required": true, |
| "description": "The id of the pet to retrieve", |
| "schema": { |
| "type": "string" |
| } |
| } |
| ], |
| "responses": { |
| "200": { |
| "description": "Expected response to a valid request", |
| "content": { |
| "application/json": { |
| "schema": { |
| "$ref": "#/components/schemas/Pets" |
| } |
| } |
| } |
| }, |
| "default": { |
| "description": "unexpected error", |
| "content": { |
| "application/json": { |
| "schema": { |
| "$ref": "#/components/schemas/Error" |
| } |
| } |
| } |
| } |
| } |
| } |
| } |
| }, |
| "components": { |
| "schemas": { |
| "Pet": { |
| "required": [ |
| "id", |
| "name" |
| ], |
| "properties": { |
| "id": { |
| "type": "integer", |
| "format": "int64" |
| }, |
| "name": { |
| "type": "string" |
| }, |
| "tag": { |
| "type": "string" |
| } |
| } |
| }, |
| "Pets": { |
| "type": "array", |
| "items": { |
| "$ref": "#/components/schemas/Pet" |
| } |
| }, |
| "Error": { |
| "required": [ |
| "code", |
| "message" |
| ], |
| "properties": { |
| "code": { |
| "type": "integer", |
| "format": "int32" |
| }, |
| "message": { |
| "type": "string" |
| } |
| } |
| } |
| } |
| } |
| } |
