Rename everything Stasis-HTTP to ARI
[asterisk/asterisk.git] / res / ari / resource_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 /*! \file
20  *
21  * \brief Implementation for ARI stubs.
22  *
23  * \author David M. Lee, II <dlee@digium.com>
24  */
25
26 /*** MODULEINFO
27         <depend type="module">res_stasis_app_playback</depend>
28         <support_level>core</support_level>
29  ***/
30
31 #include "asterisk.h"
32
33 ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
34
35 #include "asterisk/file.h"
36 #include "asterisk/pbx.h"
37 #include "asterisk/dial.h"
38 #include "asterisk/bridge.h"
39 #include "asterisk/callerid.h"
40 #include "asterisk/stasis_app.h"
41 #include "asterisk/stasis_app_playback.h"
42 #include "asterisk/stasis_app_recording.h"
43 #include "asterisk/stasis_channels.h"
44 #include "resource_channels.h"
45
46 #include <limits.h>
47
48 /*!
49  * \brief Finds the control object for a channel, filling the response with an
50  * error, if appropriate.
51  * \param[out] response Response to fill with an error if control is not found.
52  * \param channel_id ID of the channel to lookup.
53  * \return Channel control object.
54  * \return \c NULL if control object does not exist.
55  */
56 static struct stasis_app_control *find_control(
57         struct ast_ari_response *response,
58         const char *channel_id)
59 {
60         RAII_VAR(struct stasis_app_control *, control, NULL, ao2_cleanup);
61
62         ast_assert(response != NULL);
63
64         control = stasis_app_control_find_by_channel_id(channel_id);
65         if (control == NULL) {
66                 /* Distinguish between 404 and 409 errors */
67                 RAII_VAR(struct ast_channel *, chan, NULL, ao2_cleanup);
68                 chan = ast_channel_get_by_name(channel_id);
69                 if (chan == NULL) {
70                         ast_ari_response_error(response, 404, "Not Found",
71                                    "Channel not found");
72                         return NULL;
73                 }
74
75                 ast_ari_response_error(response, 409, "Conflict",
76                            "Channel not in Stasis application");
77                 return NULL;
78         }
79
80         ao2_ref(control, +1);
81         return control;
82 }
83
84 void ast_ari_dial(struct ast_variable *headers, struct ast_dial_args *args, struct ast_ari_response *response)
85 {
86         struct stasis_app_control *control;
87
88         control = find_control(response, args->channel_id);
89         if (control == NULL) {
90                 return;
91         }
92
93         if (stasis_app_control_dial(control, args->endpoint, args->timeout)) {
94                 ast_ari_response_alloc_failed(response);
95                 return;
96         }
97
98         ast_ari_response_no_content(response);
99 }
100
101 void ast_ari_continue_in_dialplan(
102         struct ast_variable *headers,
103         struct ast_continue_in_dialplan_args *args,
104         struct ast_ari_response *response)
105 {
106         RAII_VAR(struct stasis_app_control *, control, NULL, ao2_cleanup);
107
108         ast_assert(response != NULL);
109
110         control = find_control(response, args->channel_id);
111         if (control == NULL) {
112                 return;
113         }
114
115         if (stasis_app_control_continue(control, args->context, args->extension, args->priority)) {
116                 ast_ari_response_alloc_failed(response);
117                 return;
118         }
119
120         ast_ari_response_no_content(response);
121 }
122
123 void ast_ari_answer_channel(struct ast_variable *headers,
124                                 struct ast_answer_channel_args *args,
125                                 struct ast_ari_response *response)
126 {
127         RAII_VAR(struct stasis_app_control *, control, NULL, ao2_cleanup);
128
129         control = find_control(response, args->channel_id);
130         if (control == NULL) {
131                 return;
132         }
133
134         if (stasis_app_control_answer(control) != 0) {
135                 ast_ari_response_error(
136                         response, 500, "Internal Server Error",
137                         "Failed to answer channel");
138                 return;
139         }
140
141         ast_ari_response_no_content(response);
142 }
143
144 void ast_ari_mute_channel(struct ast_variable *headers, struct ast_mute_channel_args *args, struct ast_ari_response *response)
145 {
146         RAII_VAR(struct stasis_app_control *, control, NULL, ao2_cleanup);
147         unsigned int direction = 0;
148         enum ast_frame_type frametype = AST_FRAME_VOICE;
149
150         control = find_control(response, args->channel_id);
151         if (control == NULL) {
152                 return;
153         }
154
155         if (!strcmp(args->direction, "in")) {
156                 direction = AST_MUTE_DIRECTION_READ;
157         } else if (!strcmp(args->direction, "out")) {
158                 direction = AST_MUTE_DIRECTION_WRITE;
159         } else if (!strcmp(args->direction, "both")) {
160                 direction = AST_MUTE_DIRECTION_READ | AST_MUTE_DIRECTION_WRITE;
161         } else {
162                 ast_ari_response_error(
163                         response, 400, "Bad Request",
164                         "Invalid direction specified");
165                 return;
166         }
167
168         stasis_app_control_mute(control, direction, frametype);
169
170         ast_ari_response_no_content(response);
171 }
172
173 void ast_ari_unmute_channel(struct ast_variable *headers, struct ast_unmute_channel_args *args, struct ast_ari_response *response)
174 {
175         RAII_VAR(struct stasis_app_control *, control, NULL, ao2_cleanup);
176         unsigned int direction = 0;
177         enum ast_frame_type frametype = AST_FRAME_VOICE;
178
179         control = find_control(response, args->channel_id);
180         if (control == NULL) {
181                 return;
182         }
183
184         if (!strcmp(args->direction, "in")) {
185                 direction = AST_MUTE_DIRECTION_READ;
186         } else if (!strcmp(args->direction, "out")) {
187                 direction = AST_MUTE_DIRECTION_WRITE;
188         } else if (!strcmp(args->direction, "both")) {
189                 direction = AST_MUTE_DIRECTION_READ | AST_MUTE_DIRECTION_WRITE;
190         } else {
191                 ast_ari_response_error(
192                         response, 400, "Bad Request",
193                         "Invalid direction specified");
194                 return;
195         }
196
197         stasis_app_control_unmute(control, direction, frametype);
198
199         ast_ari_response_no_content(response);
200 }
201
202 void ast_ari_hold_channel(struct ast_variable *headers, struct ast_hold_channel_args *args, struct ast_ari_response *response)
203 {
204         RAII_VAR(struct stasis_app_control *, control, NULL, ao2_cleanup);
205
206         control = find_control(response, args->channel_id);
207         if (control == NULL) {
208                 /* Response filled in by find_control */
209                 return;
210         }
211
212         stasis_app_control_hold(control);
213
214         ast_ari_response_no_content(response);
215 }
216
217 void ast_ari_unhold_channel(struct ast_variable *headers, struct ast_unhold_channel_args *args, struct ast_ari_response *response)
218 {
219         RAII_VAR(struct stasis_app_control *, control, NULL, ao2_cleanup);
220
221         control = find_control(response, args->channel_id);
222         if (control == NULL) {
223                 /* Response filled in by find_control */
224                 return;
225         }
226
227         stasis_app_control_unhold(control);
228
229         ast_ari_response_no_content(response);
230 }
231
232 void ast_ari_moh_start_channel(struct ast_variable *headers, struct ast_moh_start_channel_args *args, struct ast_ari_response *response)
233 {
234         RAII_VAR(struct stasis_app_control *, control, NULL, ao2_cleanup);
235
236         control = find_control(response, args->channel_id);
237         if (control == NULL) {
238                 /* Response filled in by find_control */
239                 return;
240         }
241
242         stasis_app_control_moh_start(control, args->moh_class);
243         ast_ari_response_no_content(response);
244 }
245
246 void ast_ari_moh_stop_channel(struct ast_variable *headers, struct ast_moh_stop_channel_args *args, struct ast_ari_response *response)
247 {
248         RAII_VAR(struct stasis_app_control *, control, NULL, ao2_cleanup);
249
250         control = find_control(response, args->channel_id);
251         if (control == NULL) {
252                 /* Response filled in by find_control */
253                 return;
254         }
255
256         stasis_app_control_moh_stop(control);
257         ast_ari_response_no_content(response);
258 }
259
260 void ast_ari_play_on_channel(struct ast_variable *headers,
261         struct ast_play_on_channel_args *args,
262         struct ast_ari_response *response)
263 {
264         RAII_VAR(struct stasis_app_control *, control, NULL, ao2_cleanup);
265         RAII_VAR(struct ast_channel_snapshot *, snapshot, NULL, ao2_cleanup);
266         RAII_VAR(struct stasis_app_playback *, playback, NULL, ao2_cleanup);
267         RAII_VAR(char *, playback_url, NULL, ast_free);
268         RAII_VAR(struct ast_json *, json, NULL, ast_json_unref);
269         const char *language;
270
271         ast_assert(response != NULL);
272
273         control = find_control(response, args->channel_id);
274         if (control == NULL) {
275                 /* Response filled in by find_control */
276                 return;
277         }
278
279         snapshot = stasis_app_control_get_snapshot(control);
280         if (!snapshot) {
281                 ast_ari_response_error(
282                         response, 404, "Not Found",
283                         "Channel not found");
284                 return;
285         }
286
287         if (args->skipms < 0) {
288                 ast_ari_response_error(
289                         response, 400, "Bad Request",
290                         "skipms cannot be negative");
291                 return;
292         }
293
294         if (args->offsetms < 0) {
295                 ast_ari_response_error(
296                         response, 400, "Bad Request",
297                         "offsetms cannot be negative");
298                 return;
299         }
300
301         language = S_OR(args->lang, snapshot->language);
302
303         playback = stasis_app_control_play_uri(control, args->media, language,
304                 args->channel_id, STASIS_PLAYBACK_TARGET_CHANNEL, args->skipms, args->offsetms);
305         if (!playback) {
306                 ast_ari_response_error(
307                         response, 500, "Internal Server Error",
308                         "Failed to queue media for playback");
309                 return;
310         }
311
312         ast_asprintf(&playback_url, "/playback/%s",
313                 stasis_app_playback_get_id(playback));
314         if (!playback_url) {
315                 ast_ari_response_error(
316                         response, 500, "Internal Server Error",
317                         "Out of memory");
318                 return;
319         }
320
321         json = stasis_app_playback_to_json(playback);
322         if (!json) {
323                 ast_ari_response_error(
324                         response, 500, "Internal Server Error",
325                         "Out of memory");
326                 return;
327         }
328
329         ast_ari_response_created(response, playback_url, json);
330 }
331
332 void ast_ari_record_channel(struct ast_variable *headers,
333         struct ast_record_channel_args *args,
334         struct ast_ari_response *response)
335 {
336         RAII_VAR(struct stasis_app_control *, control, NULL, ao2_cleanup);
337         RAII_VAR(struct ast_channel_snapshot *, snapshot, NULL, ao2_cleanup);
338         RAII_VAR(struct stasis_app_recording *, recording, NULL, ao2_cleanup);
339         RAII_VAR(char *, recording_url, NULL, ast_free);
340         RAII_VAR(struct ast_json *, json, NULL, ast_json_unref);
341         RAII_VAR(struct stasis_app_recording_options *, options, NULL,
342                 ao2_cleanup);
343         RAII_VAR(char *, uri_encoded_name, NULL, ast_free);
344         size_t uri_name_maxlen;
345
346         ast_assert(response != NULL);
347
348         if (args->max_duration_seconds < 0) {
349                 ast_ari_response_error(
350                         response, 400, "Bad Request",
351                         "max_duration_seconds cannot be negative");
352                 return;
353         }
354
355         if (args->max_silence_seconds < 0) {
356                 ast_ari_response_error(
357                         response, 400, "Bad Request",
358                         "max_silence_seconds cannot be negative");
359                 return;
360         }
361
362         control = find_control(response, args->channel_id);
363         if (control == NULL) {
364                 /* Response filled in by find_control */
365                 return;
366         }
367
368         options = stasis_app_recording_options_create(args->name, args->format);
369         if (options == NULL) {
370                 ast_ari_response_error(
371                         response, 500, "Internal Server Error",
372                         "Out of memory");
373         }
374         options->max_silence_seconds = args->max_silence_seconds;
375         options->max_duration_seconds = args->max_duration_seconds;
376         options->terminate_on =
377                 stasis_app_recording_termination_parse(args->terminate_on);
378         options->if_exists =
379                 stasis_app_recording_if_exists_parse(args->if_exists);
380         options->beep = args->beep;
381
382         if (options->terminate_on == STASIS_APP_RECORDING_TERMINATE_INVALID) {
383                 ast_ari_response_error(
384                         response, 400, "Bad Request",
385                         "terminateOn invalid");
386                 return;
387         }
388
389         if (options->if_exists == -1) {
390                 ast_ari_response_error(
391                         response, 400, "Bad Request",
392                         "ifExists invalid");
393                 return;
394         }
395
396         recording = stasis_app_control_record(control, options);
397         if (recording == NULL) {
398                 switch(errno) {
399                 case EINVAL:
400                         /* While the arguments are invalid, we should have
401                          * caught them prior to calling record.
402                          */
403                         ast_ari_response_error(
404                                 response, 500, "Internal Server Error",
405                                 "Error parsing request");
406                         break;
407                 case EEXIST:
408                         ast_ari_response_error(response, 409, "Conflict",
409                                 "Recording '%s' already in progress",
410                                 args->name);
411                         break;
412                 case ENOMEM:
413                         ast_ari_response_error(
414                                 response, 500, "Internal Server Error",
415                                 "Out of memory");
416                         break;
417                 case EPERM:
418                         ast_ari_response_error(
419                                 response, 400, "Bad Request",
420                                 "Recording name invalid");
421                         break;
422                 default:
423                         ast_log(LOG_WARNING,
424                                 "Unrecognized recording error: %s\n",
425                                 strerror(errno));
426                         ast_ari_response_error(
427                                 response, 500, "Internal Server Error",
428                                 "Internal Server Error");
429                         break;
430                 }
431                 return;
432         }
433
434         uri_name_maxlen = strlen(args->name) * 3;
435         uri_encoded_name = ast_malloc(uri_name_maxlen);
436         if (!uri_encoded_name) {
437                 ast_ari_response_error(
438                         response, 500, "Internal Server Error",
439                         "Out of memory");
440                 return;
441         }
442         ast_uri_encode(args->name, uri_encoded_name, uri_name_maxlen,
443                 ast_uri_http);
444
445         ast_asprintf(&recording_url, "/recordings/live/%s", uri_encoded_name);
446         if (!recording_url) {
447                 ast_ari_response_error(
448                         response, 500, "Internal Server Error",
449                         "Out of memory");
450                 return;
451         }
452
453         json = stasis_app_recording_to_json(recording);
454         if (!json) {
455                 ast_ari_response_error(
456                         response, 500, "Internal Server Error",
457                         "Out of memory");
458                 return;
459         }
460
461         ast_ari_response_created(response, recording_url, json);
462 }
463
464 void ast_ari_get_channel(struct ast_variable *headers,
465                              struct ast_get_channel_args *args,
466                              struct ast_ari_response *response)
467 {
468         RAII_VAR(struct stasis_message *, msg, NULL, ao2_cleanup);
469         struct stasis_caching_topic *caching_topic;
470         struct ast_channel_snapshot *snapshot;
471
472         caching_topic = ast_channel_topic_all_cached();
473         if (!caching_topic) {
474                 ast_ari_response_error(
475                         response, 500, "Internal Server Error",
476                         "Message bus not initialized");
477                 return;
478         }
479
480         msg = stasis_cache_get(caching_topic, ast_channel_snapshot_type(),
481                                args->channel_id);
482         if (!msg) {
483                 ast_ari_response_error(
484                         response, 404, "Not Found",
485                         "Channel not found");
486                 return;
487         }
488
489         snapshot = stasis_message_data(msg);
490         ast_assert(snapshot != NULL);
491
492         ast_ari_response_ok(response,
493                                 ast_channel_snapshot_to_json(snapshot));
494 }
495
496 void ast_ari_delete_channel(struct ast_variable *headers,
497                                 struct ast_delete_channel_args *args,
498                                 struct ast_ari_response *response)
499 {
500         RAII_VAR(struct ast_channel *, chan, NULL, ao2_cleanup);
501
502         chan = ast_channel_get_by_name(args->channel_id);
503         if (chan == NULL) {
504                 ast_ari_response_error(
505                         response, 404, "Not Found",
506                         "Channel not found");
507                 return;
508         }
509
510         ast_softhangup(chan, AST_SOFTHANGUP_EXPLICIT);
511
512         ast_ari_response_no_content(response);
513 }
514
515 void ast_ari_get_channels(struct ast_variable *headers,
516                               struct ast_get_channels_args *args,
517                               struct ast_ari_response *response)
518 {
519         RAII_VAR(struct stasis_caching_topic *, caching_topic, NULL, ao2_cleanup);
520         RAII_VAR(struct ao2_container *, snapshots, NULL, ao2_cleanup);
521         RAII_VAR(struct ast_json *, json, NULL, ast_json_unref);
522         struct ao2_iterator i;
523         void *obj;
524
525         caching_topic = ast_channel_topic_all_cached();
526         if (!caching_topic) {
527                 ast_ari_response_error(
528                         response, 500, "Internal Server Error",
529                         "Message bus not initialized");
530                 return;
531         }
532         ao2_ref(caching_topic, +1);
533
534         snapshots = stasis_cache_dump(caching_topic, ast_channel_snapshot_type());
535         if (!snapshots) {
536                 ast_ari_response_alloc_failed(response);
537                 return;
538         }
539
540         json = ast_json_array_create();
541         if (!json) {
542                 ast_ari_response_alloc_failed(response);
543                 return;
544         }
545
546         i = ao2_iterator_init(snapshots, 0);
547         while ((obj = ao2_iterator_next(&i))) {
548                 RAII_VAR(struct stasis_message *, msg, obj, ao2_cleanup);
549                 struct ast_channel_snapshot *snapshot = stasis_message_data(msg);
550                 int r = ast_json_array_append(
551                         json, ast_channel_snapshot_to_json(snapshot));
552                 if (r != 0) {
553                         ast_ari_response_alloc_failed(response);
554                         return;
555                 }
556         }
557         ao2_iterator_destroy(&i);
558
559         ast_ari_response_ok(response, ast_json_ref(json));
560 }
561
562 void ast_ari_originate(struct ast_variable *headers,
563                            struct ast_originate_args *args,
564                            struct ast_ari_response *response)
565 {
566         char *dialtech;
567         char dialdevice[AST_CHANNEL_NAME];
568         char *caller_id = NULL;
569         char *cid_num = NULL;
570         char *cid_name = NULL;
571         int timeout = 30000;
572
573         char *stuff;
574
575         if (ast_strlen_zero(args->endpoint)) {
576                 ast_ari_response_error(response, 400, "Bad Request",
577                         "Endpoint must be specified");
578                 return;
579         }
580
581         dialtech = ast_strdupa(args->endpoint);
582         if ((stuff = strchr(dialtech, '/'))) {
583                 *stuff++ = '\0';
584                 ast_copy_string(dialdevice, stuff, sizeof(dialdevice));
585         }
586
587         if (ast_strlen_zero(dialtech) || ast_strlen_zero(dialdevice)) {
588                 ast_ari_response_error(response, 400, "Bad Request",
589                         "Invalid endpoint specified");
590                 return;
591         }
592
593         if (args->timeout > 0) {
594                 timeout = args->timeout * 1000;
595         } else if (args->timeout == -1) {
596                 timeout = -1;
597         }
598
599         if (!ast_strlen_zero(args->caller_id)) {
600                 caller_id = ast_strdupa(args->caller_id);
601                 ast_callerid_parse(caller_id, &cid_name, &cid_num);
602
603                 if (ast_is_shrinkable_phonenumber(cid_num)) {
604                         ast_shrink_phone_number(cid_num);
605                 }
606         }
607
608         if (!ast_strlen_zero(args->app)) {
609                 const char *app = "Stasis";
610
611                 RAII_VAR(struct ast_str *, appdata, ast_str_create(64), ast_free);
612
613                 if (!appdata) {
614                         ast_ari_response_alloc_failed(response);
615                         return;
616                 }
617
618                 ast_str_set(&appdata, 0, "%s", args->app);
619                 if (!ast_strlen_zero(args->app_args)) {
620                         ast_str_append(&appdata, 0, ",%s", args->app_args);
621                 }
622
623                 /* originate a channel, putting it into an application */
624                 if (ast_pbx_outgoing_app(dialtech, NULL, dialdevice, timeout, app, ast_str_buffer(appdata), NULL, 0, cid_num, cid_name, NULL, NULL, NULL)) {
625                         ast_ari_response_alloc_failed(response);
626                         return;
627                 }
628         } else if (!ast_strlen_zero(args->extension)) {
629                 /* originate a channel, sending it to an extension */
630                 if (ast_pbx_outgoing_exten(dialtech, NULL, dialdevice, timeout, S_OR(args->context, "default"), args->extension, args->priority ? args->priority : 1, NULL, 0, cid_num, cid_name, NULL, NULL, NULL, 0)) {
631                         ast_ari_response_alloc_failed(response);
632                         return;
633                 }
634         } else {
635                 ast_ari_response_error(response, 400, "Bad Request",
636                         "Application or extension must be specified");
637                 return;
638         }
639
640         ast_ari_response_no_content(response);
641 }
642
643 void ast_ari_get_channel_var(struct ast_variable *headers, struct ast_get_channel_var_args *args, struct ast_ari_response *response)
644 {
645         RAII_VAR(struct ast_json *, json, NULL, ast_json_unref);
646         RAII_VAR(struct stasis_app_control *, control, NULL, ao2_cleanup);
647         RAII_VAR(char *, value, NULL, ast_free);
648
649         ast_assert(response != NULL);
650
651         control = find_control(response, args->channel_id);
652         if (control == NULL) {
653                 return;
654         }
655
656         value = stasis_app_control_get_channel_var(control, args->variable);
657
658         if (!(json = ast_json_pack("{s: s}", "value", S_OR(value, "")))) {
659                 ast_ari_response_alloc_failed(response);
660                 return;
661         }
662
663         ast_ari_response_ok(response, ast_json_ref(json));
664 }
665
666 void ast_ari_set_channel_var(struct ast_variable *headers, struct ast_set_channel_var_args *args, struct ast_ari_response *response)
667 {
668         RAII_VAR(struct stasis_app_control *, control, NULL, ao2_cleanup);
669
670         ast_assert(response != NULL);
671
672         control = find_control(response, args->channel_id);
673         if (control == NULL) {
674                 return;
675         }
676
677         if (ast_strlen_zero(args->variable)) {
678                 ast_ari_response_error(
679                         response, 400, "Bad Request",
680                         "Variable name is required");
681                 return;
682         }
683
684         if (stasis_app_control_set_channel_var(control, args->variable, args->value)) {
685                 ast_ari_response_error(
686                         response, 400, "Bad Request",
687                         "Failed to execute function");
688                 return;
689         }
690
691         ast_ari_response_no_content(response);
692 }
693