5 changed files with 144 additions and 172 deletions
@ -1,158 +0,0 @@ |
|||||
{ |
|
||||
"swagger": "2.0", |
|
||||
"info": { |
|
||||
"title": "Beer Catalog API", |
|
||||
"description": "An API for querying beer catalog of Acme Inc.", |
|
||||
"contact": { |
|
||||
"name": "Laurent Broudoux", |
|
||||
"url": "http://github.com/lbroudoux", |
|
||||
"email": "laurent.broudoux@gmail.com" |
|
||||
}, |
|
||||
"license": { |
|
||||
"name": "MIT License", |
|
||||
"url": "https://opensource.org/licenses/MIT" |
|
||||
}, |
|
||||
"version": "0.9" |
|
||||
}, |
|
||||
"host": "beer-catalog.app.itix.fr", |
|
||||
"schemes": [ "http" ], |
|
||||
"basePath": "/api", |
|
||||
"paths": { |
|
||||
"/beer/{name}": { |
|
||||
"get": { |
|
||||
"tags": [ |
|
||||
"beer" |
|
||||
], |
|
||||
"summary": "Get beer having name", |
|
||||
"description": "Get beer having name", |
|
||||
"operationId": "GetBeer", |
|
||||
"responses": { |
|
||||
"200": { |
|
||||
"description": "Beer having requested name", |
|
||||
"schema": { |
|
||||
"$ref": "#/definitions/Beer" |
|
||||
} |
|
||||
} |
|
||||
} |
|
||||
}, |
|
||||
"parameters": [ |
|
||||
{ |
|
||||
"name": "name", |
|
||||
"in": "path", |
|
||||
"description": "Name of beer to retrieve", |
|
||||
"required": true, |
|
||||
"type": "string" |
|
||||
} |
|
||||
] |
|
||||
}, |
|
||||
"/beer/findByStatus/{status}": { |
|
||||
"get": { |
|
||||
"tags": [ |
|
||||
"beer" |
|
||||
], |
|
||||
"summary": "Get beers having status", |
|
||||
"description": "Get beers having status", |
|
||||
"operationId": "FindBeersByStatus", |
|
||||
"responses": { |
|
||||
"200": { |
|
||||
"description": "List of beers having requested status", |
|
||||
"schema": { |
|
||||
"type": "array", |
|
||||
"items": { |
|
||||
"$ref": "#/definitions/Beer" |
|
||||
} |
|
||||
} |
|
||||
} |
|
||||
} |
|
||||
}, |
|
||||
"parameters": [ |
|
||||
{ |
|
||||
"name": "status", |
|
||||
"in": "path", |
|
||||
"description": "Status of beers to retrieve", |
|
||||
"required": true, |
|
||||
"type": "string" |
|
||||
}, |
|
||||
{ |
|
||||
"name": "page", |
|
||||
"in": "query", |
|
||||
"description": "Number of page to retrieve", |
|
||||
"type": "number" |
|
||||
} |
|
||||
] |
|
||||
}, |
|
||||
"/beer": { |
|
||||
"get": { |
|
||||
"tags": [ |
|
||||
"beer" |
|
||||
], |
|
||||
"summary": "List beers within catalog", |
|
||||
"description": "List beers within catalog", |
|
||||
"operationId": "ListBeers", |
|
||||
"responses": { |
|
||||
"200": { |
|
||||
"description": "Array of beers", |
|
||||
"schema": { |
|
||||
"type": "array", |
|
||||
"items": { |
|
||||
"$ref": "#/definitions/Beer" |
|
||||
} |
|
||||
} |
|
||||
} |
|
||||
} |
|
||||
}, |
|
||||
"parameters": [ |
|
||||
{ |
|
||||
"name": "page", |
|
||||
"in": "query", |
|
||||
"description": "Number of page to retrieve", |
|
||||
"type": "number" |
|
||||
} |
|
||||
] |
|
||||
} |
|
||||
}, |
|
||||
"tags": [ |
|
||||
{ |
|
||||
"name": "beer", |
|
||||
"description": "Beer resource" |
|
||||
} |
|
||||
], |
|
||||
"definitions": { |
|
||||
"Beer": { |
|
||||
"properties": { |
|
||||
"name": { |
|
||||
"description": "Name of Beer", |
|
||||
"type": "string" |
|
||||
}, |
|
||||
"country": { |
|
||||
"description": "Origin country of Beer", |
|
||||
"type": "string" |
|
||||
}, |
|
||||
"type": { |
|
||||
"description": "Type of Beer", |
|
||||
"type": "string" |
|
||||
}, |
|
||||
"rating": { |
|
||||
"description": "Rating from customers", |
|
||||
"type": "number" |
|
||||
}, |
|
||||
"status": { |
|
||||
"description": "Stock status", |
|
||||
"type": "string" |
|
||||
} |
|
||||
} |
|
||||
} |
|
||||
}, |
|
||||
"securityDefinitions": { |
|
||||
"api-key": { |
|
||||
"type": "apiKey", |
|
||||
"name": "api-key", |
|
||||
"in": "header" |
|
||||
} |
|
||||
}, |
|
||||
"security": [ |
|
||||
{ |
|
||||
"api-key": [] |
|
||||
} |
|
||||
] |
|
||||
} |
|
||||
@ -0,0 +1,108 @@ |
|||||
|
swagger: '2.0' |
||||
|
info: |
||||
|
title: 'Beer Catalog API' |
||||
|
description: 'An API for querying beer catalog of Acme Inc.' |
||||
|
contact: |
||||
|
name: 'Laurent Broudoux' |
||||
|
url: 'http://github.com/lbroudoux' |
||||
|
email: laurent.broudoux@gmail.com |
||||
|
license: |
||||
|
name: 'MIT License' |
||||
|
url: 'https://opensource.org/licenses/MIT' |
||||
|
version: '0.9' |
||||
|
paths: |
||||
|
'/beer/{name}': |
||||
|
get: |
||||
|
tags: |
||||
|
- beer |
||||
|
summary: 'Get beer having name' |
||||
|
description: 'Get beer having name' |
||||
|
operationId: GetBeer |
||||
|
responses: |
||||
|
'200': |
||||
|
description: 'Beer having requested name' |
||||
|
schema: |
||||
|
$ref: '#/definitions/Beer' |
||||
|
parameters: |
||||
|
- |
||||
|
name: name |
||||
|
in: path |
||||
|
description: 'Name of beer to retrieve' |
||||
|
required: true |
||||
|
type: string |
||||
|
'/beer/findByStatus/{status}': |
||||
|
get: |
||||
|
tags: |
||||
|
- beer |
||||
|
summary: 'Get beers having status' |
||||
|
description: 'Get beers having status' |
||||
|
operationId: FindBeersByStatus |
||||
|
responses: |
||||
|
'200': |
||||
|
description: 'List of beers having requested status' |
||||
|
schema: |
||||
|
type: array |
||||
|
items: |
||||
|
$ref: '#/definitions/Beer' |
||||
|
parameters: |
||||
|
- |
||||
|
name: status |
||||
|
in: path |
||||
|
description: 'Status of beers to retrieve' |
||||
|
required: true |
||||
|
type: string |
||||
|
- |
||||
|
name: page |
||||
|
in: query |
||||
|
description: 'Number of page to retrieve' |
||||
|
type: number |
||||
|
/beer: |
||||
|
get: |
||||
|
tags: |
||||
|
- beer |
||||
|
summary: 'List beers within catalog' |
||||
|
description: 'List beers within catalog' |
||||
|
operationId: ListBeers |
||||
|
responses: |
||||
|
'200': |
||||
|
description: 'Array of beers' |
||||
|
schema: |
||||
|
type: array |
||||
|
items: |
||||
|
$ref: '#/definitions/Beer' |
||||
|
parameters: |
||||
|
- |
||||
|
name: page |
||||
|
in: query |
||||
|
description: 'Number of page to retrieve' |
||||
|
type: number |
||||
|
tags: |
||||
|
- |
||||
|
name: beer |
||||
|
description: 'Beer resource' |
||||
|
definitions: |
||||
|
Beer: |
||||
|
properties: |
||||
|
name: |
||||
|
description: 'Name of Beer' |
||||
|
type: string |
||||
|
country: |
||||
|
description: 'Origin country of Beer' |
||||
|
type: string |
||||
|
type: |
||||
|
description: 'Type of Beer' |
||||
|
type: string |
||||
|
rating: |
||||
|
description: 'Rating from customers' |
||||
|
type: number |
||||
|
status: |
||||
|
description: 'Stock status' |
||||
|
type: string |
||||
|
securityDefinitions: |
||||
|
api-key: |
||||
|
type: apiKey |
||||
|
name: api-key |
||||
|
in: header |
||||
|
security: |
||||
|
- |
||||
|
api-key: [] |
||||
Loading…
Reference in new issue