99 lines
2.7 KiB
YAML
99 lines
2.7 KiB
YAML
swagger: "2.0"
|
|
info:
|
|
description: "get the daily menus of selected venues"
|
|
version: "1.0.0"
|
|
title: "Hunger API"
|
|
contact:
|
|
email: "l.winkler23@mailbox.org"
|
|
license:
|
|
name: "The MIT License"
|
|
url: "https://opensource.org/licenses/MIT"
|
|
externalDocs:
|
|
description: "Github"
|
|
url: "https://github.com/findus23/hunger"
|
|
host: "hunger.lw1.at"
|
|
basePath: "/api"
|
|
paths:
|
|
|
|
/venue/:
|
|
get:
|
|
tags:
|
|
- "venues"
|
|
summary: "get a list of all venues"
|
|
description: ""
|
|
operationId: "addPet"
|
|
produces:
|
|
- "application/json"
|
|
responses:
|
|
200:
|
|
description: A User object
|
|
schema:
|
|
type: array
|
|
items:
|
|
type: object
|
|
properties:
|
|
id:
|
|
type: integer
|
|
description: The venue id.
|
|
example: 1
|
|
name:
|
|
type: string
|
|
description: The name of venue
|
|
example: https://hunger.lw1.at/api/venue/1/
|
|
meals_url:
|
|
type: string
|
|
description: absolute URL to venue.
|
|
example: Fladerei
|
|
/venue/{venueID}:
|
|
get:
|
|
tags:
|
|
- "menus"
|
|
summary: "get a list of all venues"
|
|
description: ""
|
|
produces:
|
|
- "application/json"
|
|
parameters:
|
|
- in: path
|
|
name: venueID
|
|
type: integer
|
|
required: true
|
|
description: ID of venue.
|
|
- in: query
|
|
name: mode
|
|
type: string
|
|
enum:
|
|
- day
|
|
- week
|
|
description: either `day` to get menu of current day or `week` to get menu of current week.
|
|
default: day
|
|
- in: query
|
|
name: offset
|
|
type: integer
|
|
default: 0
|
|
description: get menu of future (positive) or previous (negative) week/day
|
|
responses:
|
|
400:
|
|
description: invalid parameters
|
|
200:
|
|
description: A User object
|
|
schema:
|
|
type: array
|
|
items:
|
|
type: object
|
|
properties:
|
|
date:
|
|
type: string
|
|
description: ISO date format.
|
|
example: "2017-07-03"
|
|
name:
|
|
type: string
|
|
description: The name of the meal
|
|
example: "Speck, Jungzwiebel, Sauerrahm und Mozzarella überbacken"
|
|
description:
|
|
type: string
|
|
description: more details about the menu (can be empty).
|
|
example: ""
|
|
venue:
|
|
type: integer
|
|
description: ID of venue
|
|
example: 1
|