Merge "res_pjsip: New endpoint option "refer_blind_progress""
[asterisk/asterisk.git] / res / res_ari_playbacks.c
1 /*
2  * Asterisk -- An open source telephony toolkit.
3  *
4  * Copyright (C) 2012 - 2013, Digium, Inc.
5  *
6  * David M. Lee, II <dlee@digium.com>
7  *
8  * See http://www.asterisk.org for more information about
9  * the Asterisk project. Please do not directly contact
10  * any of the maintainers of this project for assistance;
11  * the project provides a web site, mailing lists and IRC
12  * channels for your use.
13  *
14  * This program is free software, distributed under the terms of
15  * the GNU General Public License Version 2. See the LICENSE file
16  * at the top of the source tree.
17  */
18
19 /*
20  * !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
21  * !!!!!                               DO NOT EDIT                        !!!!!
22  * !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
23  * This file is generated by a mustache template. Please see the original
24  * template in rest-api-templates/res_ari_resource.c.mustache
25  */
26
27 /*! \file
28  *
29  * \brief Playback control resources
30  *
31  * \author David M. Lee, II <dlee@digium.com>
32  */
33
34 /*** MODULEINFO
35         <depend type="module">res_ari</depend>
36         <depend type="module">res_ari_model</depend>
37         <depend type="module">res_stasis</depend>
38         <support_level>core</support_level>
39  ***/
40
41 #include "asterisk.h"
42
43 #include "asterisk/app.h"
44 #include "asterisk/module.h"
45 #include "asterisk/stasis_app.h"
46 #include "ari/resource_playbacks.h"
47 #if defined(AST_DEVMODE)
48 #include "ari/ari_model_validators.h"
49 #endif
50
51 #define MAX_VALS 128
52
53 /*!
54  * \brief Parameter parsing callback for /playbacks/{playbackId}.
55  * \param get_params GET parameters in the HTTP request.
56  * \param path_vars Path variables extracted from the request.
57  * \param headers HTTP headers.
58  * \param[out] response Response to the HTTP request.
59  */
60 static void ast_ari_playbacks_get_cb(
61         struct ast_tcptls_session_instance *ser,
62         struct ast_variable *get_params, struct ast_variable *path_vars,
63         struct ast_variable *headers, struct ast_json *body, struct ast_ari_response *response)
64 {
65         struct ast_ari_playbacks_get_args args = {};
66         struct ast_variable *i;
67 #if defined(AST_DEVMODE)
68         int is_valid;
69         int code;
70 #endif /* AST_DEVMODE */
71
72         for (i = path_vars; i; i = i->next) {
73                 if (strcmp(i->name, "playbackId") == 0) {
74                         args.playback_id = (i->value);
75                 } else
76                 {}
77         }
78         ast_ari_playbacks_get(headers, &args, response);
79 #if defined(AST_DEVMODE)
80         code = response->response_code;
81
82         switch (code) {
83         case 0: /* Implementation is still a stub, or the code wasn't set */
84                 is_valid = response->message == NULL;
85                 break;
86         case 500: /* Internal Server Error */
87         case 501: /* Not Implemented */
88         case 404: /* The playback cannot be found */
89                 is_valid = 1;
90                 break;
91         default:
92                 if (200 <= code && code <= 299) {
93                         is_valid = ast_ari_validate_playback(
94                                 response->message);
95                 } else {
96                         ast_log(LOG_ERROR, "Invalid error response %d for /playbacks/{playbackId}\n", code);
97                         is_valid = 0;
98                 }
99         }
100
101         if (!is_valid) {
102                 ast_log(LOG_ERROR, "Response validation failed for /playbacks/{playbackId}\n");
103                 ast_ari_response_error(response, 500,
104                         "Internal Server Error", "Response validation failed");
105         }
106 #endif /* AST_DEVMODE */
107
108 fin: __attribute__((unused))
109         return;
110 }
111 /*!
112  * \brief Parameter parsing callback for /playbacks/{playbackId}.
113  * \param get_params GET parameters in the HTTP request.
114  * \param path_vars Path variables extracted from the request.
115  * \param headers HTTP headers.
116  * \param[out] response Response to the HTTP request.
117  */
118 static void ast_ari_playbacks_stop_cb(
119         struct ast_tcptls_session_instance *ser,
120         struct ast_variable *get_params, struct ast_variable *path_vars,
121         struct ast_variable *headers, struct ast_json *body, struct ast_ari_response *response)
122 {
123         struct ast_ari_playbacks_stop_args args = {};
124         struct ast_variable *i;
125 #if defined(AST_DEVMODE)
126         int is_valid;
127         int code;
128 #endif /* AST_DEVMODE */
129
130         for (i = path_vars; i; i = i->next) {
131                 if (strcmp(i->name, "playbackId") == 0) {
132                         args.playback_id = (i->value);
133                 } else
134                 {}
135         }
136         ast_ari_playbacks_stop(headers, &args, response);
137 #if defined(AST_DEVMODE)
138         code = response->response_code;
139
140         switch (code) {
141         case 0: /* Implementation is still a stub, or the code wasn't set */
142                 is_valid = response->message == NULL;
143                 break;
144         case 500: /* Internal Server Error */
145         case 501: /* Not Implemented */
146         case 404: /* The playback cannot be found */
147                 is_valid = 1;
148                 break;
149         default:
150                 if (200 <= code && code <= 299) {
151                         is_valid = ast_ari_validate_void(
152                                 response->message);
153                 } else {
154                         ast_log(LOG_ERROR, "Invalid error response %d for /playbacks/{playbackId}\n", code);
155                         is_valid = 0;
156                 }
157         }
158
159         if (!is_valid) {
160                 ast_log(LOG_ERROR, "Response validation failed for /playbacks/{playbackId}\n");
161                 ast_ari_response_error(response, 500,
162                         "Internal Server Error", "Response validation failed");
163         }
164 #endif /* AST_DEVMODE */
165
166 fin: __attribute__((unused))
167         return;
168 }
169 int ast_ari_playbacks_control_parse_body(
170         struct ast_json *body,
171         struct ast_ari_playbacks_control_args *args)
172 {
173         struct ast_json *field;
174         /* Parse query parameters out of it */
175         field = ast_json_object_get(body, "operation");
176         if (field) {
177                 args->operation = ast_json_string_get(field);
178         }
179         return 0;
180 }
181
182 /*!
183  * \brief Parameter parsing callback for /playbacks/{playbackId}/control.
184  * \param get_params GET parameters in the HTTP request.
185  * \param path_vars Path variables extracted from the request.
186  * \param headers HTTP headers.
187  * \param[out] response Response to the HTTP request.
188  */
189 static void ast_ari_playbacks_control_cb(
190         struct ast_tcptls_session_instance *ser,
191         struct ast_variable *get_params, struct ast_variable *path_vars,
192         struct ast_variable *headers, struct ast_json *body, struct ast_ari_response *response)
193 {
194         struct ast_ari_playbacks_control_args args = {};
195         struct ast_variable *i;
196 #if defined(AST_DEVMODE)
197         int is_valid;
198         int code;
199 #endif /* AST_DEVMODE */
200
201         for (i = get_params; i; i = i->next) {
202                 if (strcmp(i->name, "operation") == 0) {
203                         args.operation = (i->value);
204                 } else
205                 {}
206         }
207         for (i = path_vars; i; i = i->next) {
208                 if (strcmp(i->name, "playbackId") == 0) {
209                         args.playback_id = (i->value);
210                 } else
211                 {}
212         }
213         if (ast_ari_playbacks_control_parse_body(body, &args)) {
214                 ast_ari_response_alloc_failed(response);
215                 goto fin;
216         }
217         ast_ari_playbacks_control(headers, &args, response);
218 #if defined(AST_DEVMODE)
219         code = response->response_code;
220
221         switch (code) {
222         case 0: /* Implementation is still a stub, or the code wasn't set */
223                 is_valid = response->message == NULL;
224                 break;
225         case 500: /* Internal Server Error */
226         case 501: /* Not Implemented */
227         case 400: /* The provided operation parameter was invalid */
228         case 404: /* The playback cannot be found */
229         case 409: /* The operation cannot be performed in the playback's current state */
230                 is_valid = 1;
231                 break;
232         default:
233                 if (200 <= code && code <= 299) {
234                         is_valid = ast_ari_validate_void(
235                                 response->message);
236                 } else {
237                         ast_log(LOG_ERROR, "Invalid error response %d for /playbacks/{playbackId}/control\n", code);
238                         is_valid = 0;
239                 }
240         }
241
242         if (!is_valid) {
243                 ast_log(LOG_ERROR, "Response validation failed for /playbacks/{playbackId}/control\n");
244                 ast_ari_response_error(response, 500,
245                         "Internal Server Error", "Response validation failed");
246         }
247 #endif /* AST_DEVMODE */
248
249 fin: __attribute__((unused))
250         return;
251 }
252
253 /*! \brief REST handler for /api-docs/playbacks.json */
254 static struct stasis_rest_handlers playbacks_playbackId_control = {
255         .path_segment = "control",
256         .callbacks = {
257                 [AST_HTTP_POST] = ast_ari_playbacks_control_cb,
258         },
259         .num_children = 0,
260         .children = {  }
261 };
262 /*! \brief REST handler for /api-docs/playbacks.json */
263 static struct stasis_rest_handlers playbacks_playbackId = {
264         .path_segment = "playbackId",
265         .is_wildcard = 1,
266         .callbacks = {
267                 [AST_HTTP_GET] = ast_ari_playbacks_get_cb,
268                 [AST_HTTP_DELETE] = ast_ari_playbacks_stop_cb,
269         },
270         .num_children = 1,
271         .children = { &playbacks_playbackId_control, }
272 };
273 /*! \brief REST handler for /api-docs/playbacks.json */
274 static struct stasis_rest_handlers playbacks = {
275         .path_segment = "playbacks",
276         .callbacks = {
277         },
278         .num_children = 1,
279         .children = { &playbacks_playbackId, }
280 };
281
282 static int unload_module(void)
283 {
284         ast_ari_remove_handler(&playbacks);
285         stasis_app_unref();
286         return 0;
287 }
288
289 static int load_module(void)
290 {
291         int res = 0;
292         stasis_app_ref();
293         res |= ast_ari_add_handler(&playbacks);
294         if (res) {
295                 unload_module();
296                 return AST_MODULE_LOAD_DECLINE;
297         }
298
299         return AST_MODULE_LOAD_SUCCESS;
300 }
301
302 AST_MODULE_INFO(ASTERISK_GPL_KEY, AST_MODFLAG_DEFAULT, "RESTful API module - Playback control resources",
303         .support_level = AST_MODULE_SUPPORT_CORE,
304         .load = load_module,
305         .unload = unload_module,
306         .nonoptreq = "res_ari,res_stasis",
307 );