/
swagger.yaml
226 lines (226 loc) · 4.98 KB
/
swagger.yaml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
swagger: "2.0"
info:
version: 1.0.0
title: "DISIer"
description: "E' possibile fare delle richieste a DISIer attraverso delle API. Queste API permettono di interagire con il bot e di scoprire se una certa aula è libera in quel momento."
termsOfService: http://swagger.io/terms/
contact:
name: DISIer Team
email: davide.farina-1@studenti.unitn.it
url: https://is2-progetto.herokuapp.com
license:
name: MIT
url: http://github.com/gruntjs/grunt/blob/master/LICENSE-MIT
host: is2-progetto.herokuapp.com
basePath: /
schemes:
- http
consumes:
- application/json
produces:
- application/json
paths:
/bot_message:
get:
description: |
Risponde alla domanda fatta dall'utente. Al bot si possono chiedere informazioni riguardo agli orari degli autobus.
operationId: botMessageGet
parameters:
- name: msg
in: query
description: Domanda da porre al bot
required: true
type: string
responses:
200:
description: Risposta del bot
schema:
type: array
items:
$ref: '#/definitions/BotResponse'
default:
description: Errore
schema:
$ref: '#/definitions/Error'
/aule:
get:
description: |
Fornisce gli eventi in corso in ogni aula delle sedi di Povo per ogni ora del giorno corrente.
responses:
200:
description: Risposta da aule
schema:
type: array
items:
$ref: '#/definitions/jsonAule'
default:
description: unexpected error
schema:
$ref: '#/definitions/Error'
/orari:
get:
description: |
Fornisce gli orari del corso di studi nella settimana corrente.
parameters:
- name: corso
in: query
description: Nome del corso di studi
required: true
type: string
- name: anno2
in: query
description: Anno relativo al corso di studi
required: true
type: string
responses:
200:
description: Risposta da orari
schema:
type: array
items:
$ref: '#/definitions/jsonOrari'
default:
description: unexpected error
schema:
$ref: '#/definitions/Error'
definitions:
BotResponse:
required:
- speech
- displayText
- data
- contextOut
- source
properties:
speech:
type: string
displayText:
type: string
data:
type: object
contextOut:
type: array
source:
type: string
jsonAule:
required:
- fasce
- config
- area_rooms
- contains_events
- n_events
- events
- rooms
- legenda
- table
- order
- colori
properties:
fasce:
type: array
config:
type: object
area_rooms:
type: object
contains_events:
type: integer
format: int32
n_events:
type: integer
format: int32
events:
type: array
rooms:
type: object
legenda:
type: array
table:
type: object
order:
type: array
colori:
type: array
jsonOrari:
required:
- day
- giorni
- fasce
- granularita
- start_slot
- end_slot
- colori
- first_day
- last_day
- anno
- lang
- num_fasce
- fisrt_day_label
- last_day_label
- tipo
- cds
- anno2
- celle
- legenda
- note_generali
- date_inizio_fine_curriculum
- aa
- all_events
properties:
day:
type: string
giorni:
type: array
fasce:
type: array
granularita:
type: string
start_slot:
type: string
end_slot:
type: string
colori:
type: array
first_day:
type: string
last_day:
type: string
anno:
type: string
lang:
type: string
num_fasce:
type: integer
format: int32
fisrt_day_label:
type: string
last_day_label:
type: string
tipo:
type: string
cds:
type: string
anno2:
type: string
celle:
type: array
legenda:
type: array
note_generali:
type: array
date_inizio_fine_curriculum:
type: array
aa:
type: string
all_events:
type: integer
format: int32
Error:
required:
- code
- message
properties:
code:
type: integer
format: int32
message:
type: string