stasis-http: Provide a response body for 201 created responses
[asterisk/asterisk.git] / res / stasis_http / resource_channels.c
1 /* -*- C -*-
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 stasis-http 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/stasis_app.h"
37 #include "asterisk/stasis_app_playback.h"
38 #include "asterisk/stasis_channels.h"
39 #include "resource_channels.h"
40
41 #include <limits.h>
42
43 /*!
44  * \brief Finds the control object for a channel, filling the response with an
45  * error, if appropriate.
46  * \param[out] response Response to fill with an error if control is not found.
47  * \param channel_id ID of the channel to lookup.
48  * \return Channel control object.
49  * \return \c NULL if control object does not exist.
50  */
51 static struct stasis_app_control *find_control(
52         struct stasis_http_response *response,
53         const char *channel_id)
54 {
55         RAII_VAR(struct stasis_app_control *, control, NULL, ao2_cleanup);
56
57         ast_assert(response != NULL);
58
59         control = stasis_app_control_find_by_channel_id(channel_id);
60         if (control == NULL) {
61                 /* Distinguish between 404 and 409 errors */
62                 RAII_VAR(struct ast_channel *, chan, NULL, ao2_cleanup);
63                 chan = ast_channel_get_by_name(channel_id);
64                 if (chan == NULL) {
65                         stasis_http_response_error(response, 404, "Not Found",
66                                    "Channel not found");
67                         return NULL;
68                 }
69
70                 stasis_http_response_error(response, 409, "Conflict",
71                            "Channel not in Stasis application");
72                 return NULL;
73         }
74
75         ao2_ref(control, +1);
76         return control;
77 }
78
79 void stasis_http_dial(struct ast_variable *headers, struct ast_dial_args *args, struct stasis_http_response *response)
80 {
81         ast_log(LOG_ERROR, "TODO: stasis_http_dial\n");
82 }
83
84 void stasis_http_continue_in_dialplan(
85         struct ast_variable *headers,
86         struct ast_continue_in_dialplan_args *args,
87         struct stasis_http_response *response)
88 {
89         RAII_VAR(struct stasis_app_control *, control, NULL, ao2_cleanup);
90
91         ast_assert(response != NULL);
92
93         control = find_control(response, args->channel_id);
94         if (control == NULL) {
95                 return;
96         }
97
98         stasis_app_control_continue(control);
99         stasis_http_response_no_content(response);
100 }
101
102 void stasis_http_answer_channel(struct ast_variable *headers,
103                                 struct ast_answer_channel_args *args,
104                                 struct stasis_http_response *response)
105 {
106         RAII_VAR(struct stasis_app_control *, control, NULL, ao2_cleanup);
107
108         control = find_control(response, args->channel_id);
109         if (control == NULL) {
110                 return;
111         }
112
113         if (stasis_app_control_answer(control) != 0) {
114                 stasis_http_response_error(
115                         response, 500, "Internal Server Error",
116                         "Failed to answer channel");
117                 return;
118         }
119
120         stasis_http_response_no_content(response);
121 }
122
123 void stasis_http_mute_channel(struct ast_variable *headers, struct ast_mute_channel_args *args, struct stasis_http_response *response)
124 {
125         ast_log(LOG_ERROR, "TODO: stasis_http_mute_channel\n");
126 }
127 void stasis_http_unmute_channel(struct ast_variable *headers, struct ast_unmute_channel_args *args, struct stasis_http_response *response)
128 {
129         ast_log(LOG_ERROR, "TODO: stasis_http_unmute_channel\n");
130 }
131 void stasis_http_hold_channel(struct ast_variable *headers, struct ast_hold_channel_args *args, struct stasis_http_response *response)
132 {
133         ast_log(LOG_ERROR, "TODO: stasis_http_hold_channel\n");
134 }
135 void stasis_http_unhold_channel(struct ast_variable *headers, struct ast_unhold_channel_args *args, struct stasis_http_response *response)
136 {
137         ast_log(LOG_ERROR, "TODO: stasis_http_unhold_channel\n");
138 }
139
140 void stasis_http_play_on_channel(struct ast_variable *headers,
141         struct ast_play_on_channel_args *args,
142         struct stasis_http_response *response)
143 {
144         RAII_VAR(struct stasis_app_control *, control, NULL, ao2_cleanup);
145         RAII_VAR(struct ast_channel_snapshot *, snapshot, NULL, ao2_cleanup);
146         RAII_VAR(struct stasis_app_playback *, playback, NULL, ao2_cleanup);
147         RAII_VAR(char *, playback_url, NULL, ast_free);
148         RAII_VAR(struct ast_json *, json, NULL, ast_json_unref);
149         const char *language;
150
151         ast_assert(response != NULL);
152
153         control = find_control(response, args->channel_id);
154         if (control == NULL) {
155                 /* Response filled in by find_control */
156                 return;
157         }
158
159         snapshot = stasis_app_control_get_snapshot(control);
160         if (!snapshot) {
161                 stasis_http_response_error(
162                         response, 404, "Not Found",
163                         "Channel not found");
164                 return;
165         }
166
167         if (args->skipms < 0) {
168                 stasis_http_response_error(
169                         response, 500, "Internal Server Error",
170                         "skipms cannot be negative");
171                 return;
172         }
173
174         if (args->offsetms < 0) {
175                 stasis_http_response_error(
176                         response, 500, "Internal Server Error",
177                         "offsetms cannot be negative");
178                 return;
179         }
180
181         language = S_OR(args->lang, snapshot->language);
182
183         playback = stasis_app_control_play_uri(control, args->media, language,
184                 args->skipms, args->offsetms);
185         if (!playback) {
186                 stasis_http_response_error(
187                         response, 500, "Internal Server Error",
188                         "Failed to queue media for playback");
189                 return;
190         }
191
192         ast_asprintf(&playback_url, "/playback/%s",
193                 stasis_app_playback_get_id(playback));
194         if (!playback_url) {
195                 stasis_http_response_error(
196                         response, 500, "Internal Server Error",
197                         "Out of memory");
198                 return;
199         }
200
201         json = stasis_app_playback_to_json(playback);
202         if (!json) {
203                 stasis_http_response_error(
204                         response, 500, "Internal Server Error",
205                         "Out of memory");
206                 return;
207         }
208
209         stasis_http_response_created(response, playback_url, json);
210 }
211 void stasis_http_record_channel(struct ast_variable *headers, struct ast_record_channel_args *args, struct stasis_http_response *response)
212 {
213         ast_log(LOG_ERROR, "TODO: stasis_http_record_channel\n");
214 }
215 void stasis_http_get_channel(struct ast_variable *headers,
216                              struct ast_get_channel_args *args,
217                              struct stasis_http_response *response)
218 {
219         RAII_VAR(struct stasis_message *, msg, NULL, ao2_cleanup);
220         struct stasis_caching_topic *caching_topic;
221         struct ast_channel_snapshot *snapshot;
222
223         caching_topic = ast_channel_topic_all_cached();
224         if (!caching_topic) {
225                 stasis_http_response_error(
226                         response, 500, "Internal Server Error",
227                         "Message bus not initialized");
228                 return;
229         }
230
231         msg = stasis_cache_get(caching_topic, ast_channel_snapshot_type(),
232                                args->channel_id);
233         if (!msg) {
234                 stasis_http_response_error(
235                         response, 404, "Not Found",
236                         "Channel not found");
237                 return;
238         }
239
240         snapshot = stasis_message_data(msg);
241         ast_assert(snapshot != NULL);
242
243         stasis_http_response_ok(response,
244                                 ast_channel_snapshot_to_json(snapshot));
245 }
246
247 void stasis_http_delete_channel(struct ast_variable *headers,
248                                 struct ast_delete_channel_args *args,
249                                 struct stasis_http_response *response)
250 {
251         RAII_VAR(struct ast_channel *, chan, NULL, ao2_cleanup);
252
253         chan = ast_channel_get_by_name(args->channel_id);
254         if (chan == NULL) {
255                 stasis_http_response_error(
256                         response, 404, "Not Found",
257                         "Channel not found");
258                 return;
259         }
260
261         ast_softhangup(chan, AST_SOFTHANGUP_EXPLICIT);
262
263         stasis_http_response_no_content(response);
264 }
265
266 void stasis_http_get_channels(struct ast_variable *headers,
267                               struct ast_get_channels_args *args,
268                               struct stasis_http_response *response)
269 {
270         RAII_VAR(struct stasis_caching_topic *, caching_topic, NULL, ao2_cleanup);
271         RAII_VAR(struct ao2_container *, snapshots, NULL, ao2_cleanup);
272         RAII_VAR(struct ast_json *, json, NULL, ast_json_unref);
273         struct ao2_iterator i;
274         void *obj;
275
276         caching_topic = ast_channel_topic_all_cached();
277         if (!caching_topic) {
278                 stasis_http_response_error(
279                         response, 500, "Internal Server Error",
280                         "Message bus not initialized");
281                 return;
282         }
283         ao2_ref(caching_topic, +1);
284
285         snapshots = stasis_cache_dump(caching_topic, ast_channel_snapshot_type());
286         if (!snapshots) {
287                 stasis_http_response_alloc_failed(response);
288                 return;
289         }
290
291         json = ast_json_array_create();
292         if (!json) {
293                 stasis_http_response_alloc_failed(response);
294                 return;
295         }
296
297         i = ao2_iterator_init(snapshots, 0);
298         while ((obj = ao2_iterator_next(&i))) {
299                 RAII_VAR(struct stasis_message *, msg, obj, ao2_cleanup);
300                 struct ast_channel_snapshot *snapshot = stasis_message_data(msg);
301                 int r = ast_json_array_append(
302                         json, ast_channel_snapshot_to_json(snapshot));
303                 if (r != 0) {
304                         stasis_http_response_alloc_failed(response);
305                         return;
306                 }
307         }
308         ao2_iterator_destroy(&i);
309
310         stasis_http_response_ok(response, ast_json_ref(json));
311 }
312
313 void stasis_http_originate(struct ast_variable *headers,
314                            struct ast_originate_args *args,
315                            struct stasis_http_response *response)
316 {
317         if (args->endpoint) {
318                 ast_log(LOG_DEBUG, "Dialing specific endpoint %s\n", args->endpoint);
319         }
320
321         ast_log(LOG_DEBUG, "Dialing %s@%s\n", args->extension, args->context);
322         /* ast_pbx_outgoing_app - originates a channel, putting it into an application */
323 }