This patch adds a RESTful HTTP interface to Asterisk.
[asterisk/asterisk.git] / res / res_stasis_http_channels.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_stasis_http_resource.c.mustache
25  */
26
27 /*! \file
28  *
29  * \brief Channel resources
30  *
31  * \author David M. Lee, II <dlee@digium.com>
32  */
33
34 /*** MODULEINFO
35         <depend type="module">res_stasis_http</depend>
36         <support_level>core</support_level>
37  ***/
38
39 #include "asterisk.h"
40
41 ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
42
43 #include "asterisk/module.h"
44 #include "stasis_http/resource_channels.h"
45
46 /*!
47  * \brief Parameter parsing callback for /channels.
48  * \param get_params GET parameters in the HTTP request.
49  * \param path_vars Path variables extracted from the request.
50  * \param headers HTTP headers.
51  * \param[out] response Response to the HTTP request.
52  */
53 static void stasis_http_get_channels_cb(
54     struct ast_variable *get_params, struct ast_variable *path_vars,
55     struct ast_variable *headers, struct stasis_http_response *response)
56 {
57         struct ast_get_channels_args args = {};
58         stasis_http_get_channels(headers, &args, response);
59 }
60 /*!
61  * \brief Parameter parsing callback for /channels.
62  * \param get_params GET parameters in the HTTP request.
63  * \param path_vars Path variables extracted from the request.
64  * \param headers HTTP headers.
65  * \param[out] response Response to the HTTP request.
66  */
67 static void stasis_http_originate_cb(
68     struct ast_variable *get_params, struct ast_variable *path_vars,
69     struct ast_variable *headers, struct stasis_http_response *response)
70 {
71         struct ast_originate_args args = {};
72         struct ast_variable *i;
73
74         for (i = get_params; i; i = i->next) {
75                 if (strcmp(i->name, "endpoint") == 0) {
76                         args.endpoint = (i->value);
77                 } else
78                 if (strcmp(i->name, "extension") == 0) {
79                         args.extension = (i->value);
80                 } else
81                 if (strcmp(i->name, "context") == 0) {
82                         args.context = (i->value);
83                 } else
84                 {}
85         }
86         stasis_http_originate(headers, &args, response);
87 }
88 /*!
89  * \brief Parameter parsing callback for /channels/{channelId}.
90  * \param get_params GET parameters in the HTTP request.
91  * \param path_vars Path variables extracted from the request.
92  * \param headers HTTP headers.
93  * \param[out] response Response to the HTTP request.
94  */
95 static void stasis_http_get_channel_cb(
96     struct ast_variable *get_params, struct ast_variable *path_vars,
97     struct ast_variable *headers, struct stasis_http_response *response)
98 {
99         struct ast_get_channel_args args = {};
100         struct ast_variable *i;
101
102         for (i = path_vars; i; i = i->next) {
103                 if (strcmp(i->name, "channelId") == 0) {
104                         args.channel_id = (i->value);
105                 } else
106                 {}
107         }
108         stasis_http_get_channel(headers, &args, response);
109 }
110 /*!
111  * \brief Parameter parsing callback for /channels/{channelId}.
112  * \param get_params GET parameters in the HTTP request.
113  * \param path_vars Path variables extracted from the request.
114  * \param headers HTTP headers.
115  * \param[out] response Response to the HTTP request.
116  */
117 static void stasis_http_delete_channel_cb(
118     struct ast_variable *get_params, struct ast_variable *path_vars,
119     struct ast_variable *headers, struct stasis_http_response *response)
120 {
121         struct ast_delete_channel_args args = {};
122         struct ast_variable *i;
123
124         for (i = path_vars; i; i = i->next) {
125                 if (strcmp(i->name, "channelId") == 0) {
126                         args.channel_id = (i->value);
127                 } else
128                 {}
129         }
130         stasis_http_delete_channel(headers, &args, response);
131 }
132 /*!
133  * \brief Parameter parsing callback for /channels/{channelId}/dial.
134  * \param get_params GET parameters in the HTTP request.
135  * \param path_vars Path variables extracted from the request.
136  * \param headers HTTP headers.
137  * \param[out] response Response to the HTTP request.
138  */
139 static void stasis_http_dial_cb(
140     struct ast_variable *get_params, struct ast_variable *path_vars,
141     struct ast_variable *headers, struct stasis_http_response *response)
142 {
143         struct ast_dial_args args = {};
144         struct ast_variable *i;
145
146         for (i = get_params; i; i = i->next) {
147                 if (strcmp(i->name, "endpoint") == 0) {
148                         args.endpoint = (i->value);
149                 } else
150                 if (strcmp(i->name, "extension") == 0) {
151                         args.extension = (i->value);
152                 } else
153                 if (strcmp(i->name, "context") == 0) {
154                         args.context = (i->value);
155                 } else
156                 {}
157         }
158         for (i = path_vars; i; i = i->next) {
159                 if (strcmp(i->name, "channelId") == 0) {
160                         args.channel_id = (i->value);
161                 } else
162                 {}
163         }
164         stasis_http_dial(headers, &args, response);
165 }
166 /*!
167  * \brief Parameter parsing callback for /channels/{channelId}/continue.
168  * \param get_params GET parameters in the HTTP request.
169  * \param path_vars Path variables extracted from the request.
170  * \param headers HTTP headers.
171  * \param[out] response Response to the HTTP request.
172  */
173 static void stasis_http_continue_in_dialplan_cb(
174     struct ast_variable *get_params, struct ast_variable *path_vars,
175     struct ast_variable *headers, struct stasis_http_response *response)
176 {
177         struct ast_continue_in_dialplan_args args = {};
178         struct ast_variable *i;
179
180         for (i = path_vars; i; i = i->next) {
181                 if (strcmp(i->name, "channelId") == 0) {
182                         args.channel_id = (i->value);
183                 } else
184                 {}
185         }
186         stasis_http_continue_in_dialplan(headers, &args, response);
187 }
188 /*!
189  * \brief Parameter parsing callback for /channels/{channelId}/answer.
190  * \param get_params GET parameters in the HTTP request.
191  * \param path_vars Path variables extracted from the request.
192  * \param headers HTTP headers.
193  * \param[out] response Response to the HTTP request.
194  */
195 static void stasis_http_answer_channel_cb(
196     struct ast_variable *get_params, struct ast_variable *path_vars,
197     struct ast_variable *headers, struct stasis_http_response *response)
198 {
199         struct ast_answer_channel_args args = {};
200         struct ast_variable *i;
201
202         for (i = path_vars; i; i = i->next) {
203                 if (strcmp(i->name, "channelId") == 0) {
204                         args.channel_id = (i->value);
205                 } else
206                 {}
207         }
208         stasis_http_answer_channel(headers, &args, response);
209 }
210 /*!
211  * \brief Parameter parsing callback for /channels/{channelId}/mute.
212  * \param get_params GET parameters in the HTTP request.
213  * \param path_vars Path variables extracted from the request.
214  * \param headers HTTP headers.
215  * \param[out] response Response to the HTTP request.
216  */
217 static void stasis_http_mute_channel_cb(
218     struct ast_variable *get_params, struct ast_variable *path_vars,
219     struct ast_variable *headers, struct stasis_http_response *response)
220 {
221         struct ast_mute_channel_args args = {};
222         struct ast_variable *i;
223
224         for (i = get_params; i; i = i->next) {
225                 if (strcmp(i->name, "direction") == 0) {
226                         args.direction = (i->value);
227                 } else
228                 {}
229         }
230         for (i = path_vars; i; i = i->next) {
231                 if (strcmp(i->name, "channelId") == 0) {
232                         args.channel_id = (i->value);
233                 } else
234                 {}
235         }
236         stasis_http_mute_channel(headers, &args, response);
237 }
238 /*!
239  * \brief Parameter parsing callback for /channels/{channelId}/unmute.
240  * \param get_params GET parameters in the HTTP request.
241  * \param path_vars Path variables extracted from the request.
242  * \param headers HTTP headers.
243  * \param[out] response Response to the HTTP request.
244  */
245 static void stasis_http_unmute_channel_cb(
246     struct ast_variable *get_params, struct ast_variable *path_vars,
247     struct ast_variable *headers, struct stasis_http_response *response)
248 {
249         struct ast_unmute_channel_args args = {};
250         struct ast_variable *i;
251
252         for (i = get_params; i; i = i->next) {
253                 if (strcmp(i->name, "direction") == 0) {
254                         args.direction = (i->value);
255                 } else
256                 {}
257         }
258         for (i = path_vars; i; i = i->next) {
259                 if (strcmp(i->name, "channelId") == 0) {
260                         args.channel_id = (i->value);
261                 } else
262                 {}
263         }
264         stasis_http_unmute_channel(headers, &args, response);
265 }
266 /*!
267  * \brief Parameter parsing callback for /channels/{channelId}/hold.
268  * \param get_params GET parameters in the HTTP request.
269  * \param path_vars Path variables extracted from the request.
270  * \param headers HTTP headers.
271  * \param[out] response Response to the HTTP request.
272  */
273 static void stasis_http_hold_channel_cb(
274     struct ast_variable *get_params, struct ast_variable *path_vars,
275     struct ast_variable *headers, struct stasis_http_response *response)
276 {
277         struct ast_hold_channel_args args = {};
278         struct ast_variable *i;
279
280         for (i = path_vars; i; i = i->next) {
281                 if (strcmp(i->name, "channelId") == 0) {
282                         args.channel_id = (i->value);
283                 } else
284                 {}
285         }
286         stasis_http_hold_channel(headers, &args, response);
287 }
288 /*!
289  * \brief Parameter parsing callback for /channels/{channelId}/unhold.
290  * \param get_params GET parameters in the HTTP request.
291  * \param path_vars Path variables extracted from the request.
292  * \param headers HTTP headers.
293  * \param[out] response Response to the HTTP request.
294  */
295 static void stasis_http_unhold_channel_cb(
296     struct ast_variable *get_params, struct ast_variable *path_vars,
297     struct ast_variable *headers, struct stasis_http_response *response)
298 {
299         struct ast_unhold_channel_args args = {};
300         struct ast_variable *i;
301
302         for (i = path_vars; i; i = i->next) {
303                 if (strcmp(i->name, "channelId") == 0) {
304                         args.channel_id = (i->value);
305                 } else
306                 {}
307         }
308         stasis_http_unhold_channel(headers, &args, response);
309 }
310 /*!
311  * \brief Parameter parsing callback for /channels/{channelId}/play.
312  * \param get_params GET parameters in the HTTP request.
313  * \param path_vars Path variables extracted from the request.
314  * \param headers HTTP headers.
315  * \param[out] response Response to the HTTP request.
316  */
317 static void stasis_http_play_on_channel_cb(
318     struct ast_variable *get_params, struct ast_variable *path_vars,
319     struct ast_variable *headers, struct stasis_http_response *response)
320 {
321         struct ast_play_on_channel_args args = {};
322         struct ast_variable *i;
323
324         for (i = get_params; i; i = i->next) {
325                 if (strcmp(i->name, "media") == 0) {
326                         args.media = (i->value);
327                 } else
328                 {}
329         }
330         for (i = path_vars; i; i = i->next) {
331                 if (strcmp(i->name, "channelId") == 0) {
332                         args.channel_id = (i->value);
333                 } else
334                 {}
335         }
336         stasis_http_play_on_channel(headers, &args, response);
337 }
338 /*!
339  * \brief Parameter parsing callback for /channels/{channelId}/record.
340  * \param get_params GET parameters in the HTTP request.
341  * \param path_vars Path variables extracted from the request.
342  * \param headers HTTP headers.
343  * \param[out] response Response to the HTTP request.
344  */
345 static void stasis_http_record_channel_cb(
346     struct ast_variable *get_params, struct ast_variable *path_vars,
347     struct ast_variable *headers, struct stasis_http_response *response)
348 {
349         struct ast_record_channel_args args = {};
350         struct ast_variable *i;
351
352         for (i = get_params; i; i = i->next) {
353                 if (strcmp(i->name, "name") == 0) {
354                         args.name = (i->value);
355                 } else
356                 if (strcmp(i->name, "format") == 0) {
357                         args.format = (i->value);
358                 } else
359                 if (strcmp(i->name, "maxDurationSeconds") == 0) {
360                         args.max_duration_seconds = atoi(i->value);
361                 } else
362                 if (strcmp(i->name, "maxSilenceSeconds") == 0) {
363                         args.max_silence_seconds = atoi(i->value);
364                 } else
365                 if (strcmp(i->name, "append") == 0) {
366                         args.append = atoi(i->value);
367                 } else
368                 if (strcmp(i->name, "beep") == 0) {
369                         args.beep = atoi(i->value);
370                 } else
371                 if (strcmp(i->name, "terminateOn") == 0) {
372                         args.terminate_on = (i->value);
373                 } else
374                 {}
375         }
376         for (i = path_vars; i; i = i->next) {
377                 if (strcmp(i->name, "channelId") == 0) {
378                         args.channel_id = (i->value);
379                 } else
380                 {}
381         }
382         stasis_http_record_channel(headers, &args, response);
383 }
384
385 /*! \brief REST handler for /api-docs/channels.{format} */
386 static struct stasis_rest_handlers channels_channelId_dial = {
387         .path_segment = "dial",
388         .callbacks = {
389                 [AST_HTTP_POST] = stasis_http_dial_cb,
390         },
391         .num_children = 0,
392         .children = {  }
393 };
394 /*! \brief REST handler for /api-docs/channels.{format} */
395 static struct stasis_rest_handlers channels_channelId_continue = {
396         .path_segment = "continue",
397         .callbacks = {
398                 [AST_HTTP_POST] = stasis_http_continue_in_dialplan_cb,
399         },
400         .num_children = 0,
401         .children = {  }
402 };
403 /*! \brief REST handler for /api-docs/channels.{format} */
404 static struct stasis_rest_handlers channels_channelId_answer = {
405         .path_segment = "answer",
406         .callbacks = {
407                 [AST_HTTP_POST] = stasis_http_answer_channel_cb,
408         },
409         .num_children = 0,
410         .children = {  }
411 };
412 /*! \brief REST handler for /api-docs/channels.{format} */
413 static struct stasis_rest_handlers channels_channelId_mute = {
414         .path_segment = "mute",
415         .callbacks = {
416                 [AST_HTTP_POST] = stasis_http_mute_channel_cb,
417         },
418         .num_children = 0,
419         .children = {  }
420 };
421 /*! \brief REST handler for /api-docs/channels.{format} */
422 static struct stasis_rest_handlers channels_channelId_unmute = {
423         .path_segment = "unmute",
424         .callbacks = {
425                 [AST_HTTP_POST] = stasis_http_unmute_channel_cb,
426         },
427         .num_children = 0,
428         .children = {  }
429 };
430 /*! \brief REST handler for /api-docs/channels.{format} */
431 static struct stasis_rest_handlers channels_channelId_hold = {
432         .path_segment = "hold",
433         .callbacks = {
434                 [AST_HTTP_POST] = stasis_http_hold_channel_cb,
435         },
436         .num_children = 0,
437         .children = {  }
438 };
439 /*! \brief REST handler for /api-docs/channels.{format} */
440 static struct stasis_rest_handlers channels_channelId_unhold = {
441         .path_segment = "unhold",
442         .callbacks = {
443                 [AST_HTTP_POST] = stasis_http_unhold_channel_cb,
444         },
445         .num_children = 0,
446         .children = {  }
447 };
448 /*! \brief REST handler for /api-docs/channels.{format} */
449 static struct stasis_rest_handlers channels_channelId_play = {
450         .path_segment = "play",
451         .callbacks = {
452                 [AST_HTTP_POST] = stasis_http_play_on_channel_cb,
453         },
454         .num_children = 0,
455         .children = {  }
456 };
457 /*! \brief REST handler for /api-docs/channels.{format} */
458 static struct stasis_rest_handlers channels_channelId_record = {
459         .path_segment = "record",
460         .callbacks = {
461                 [AST_HTTP_POST] = stasis_http_record_channel_cb,
462         },
463         .num_children = 0,
464         .children = {  }
465 };
466 /*! \brief REST handler for /api-docs/channels.{format} */
467 static struct stasis_rest_handlers channels_channelId = {
468         .path_segment = "channelId",
469         .is_wildcard = 1,
470         .callbacks = {
471                 [AST_HTTP_GET] = stasis_http_get_channel_cb,
472                 [AST_HTTP_DELETE] = stasis_http_delete_channel_cb,
473         },
474         .num_children = 9,
475         .children = { &channels_channelId_dial,&channels_channelId_continue,&channels_channelId_answer,&channels_channelId_mute,&channels_channelId_unmute,&channels_channelId_hold,&channels_channelId_unhold,&channels_channelId_play,&channels_channelId_record, }
476 };
477 /*! \brief REST handler for /api-docs/channels.{format} */
478 static struct stasis_rest_handlers channels = {
479         .path_segment = "channels",
480         .callbacks = {
481                 [AST_HTTP_GET] = stasis_http_get_channels_cb,
482                 [AST_HTTP_POST] = stasis_http_originate_cb,
483         },
484         .num_children = 1,
485         .children = { &channels_channelId, }
486 };
487
488 static int load_module(void)
489 {
490         return stasis_http_add_handler(&channels);
491 }
492
493 static int unload_module(void)
494 {
495         stasis_http_remove_handler(&channels);
496         return 0;
497 }
498
499 AST_MODULE_INFO(ASTERISK_GPL_KEY, AST_MODFLAG_DEFAULT,
500         "RESTful API module - Channel resources",
501         .load = load_module,
502         .unload = unload_module,
503         .nonoptreq = "res_stasis_http",
504         );