mirror of
				https://github.com/asterisk/asterisk.git
				synced 2025-10-31 10:47:18 +00:00 
			
		
		
		
	Now that the ARI implementation is nearing some definition of completeness, we should properly respond with 501's for unimplemented functionality, instead of the almost humorous 418. git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@395136 65c4cc65-6c06-0410-ace0-fbb531ad65f3
		
			
				
	
	
		
			265 lines
		
	
	
		
			7.2 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			265 lines
		
	
	
		
			7.2 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
| /*
 | |
|  * Asterisk -- An open source telephony toolkit.
 | |
|  *
 | |
|  * Copyright (C) 2012 - 2013, Digium, Inc.
 | |
|  *
 | |
|  * David M. Lee, II <dlee@digium.com>
 | |
|  *
 | |
|  * See http://www.asterisk.org for more information about
 | |
|  * the Asterisk project. Please do not directly contact
 | |
|  * any of the maintainers of this project for assistance;
 | |
|  * the project provides a web site, mailing lists and IRC
 | |
|  * channels for your use.
 | |
|  *
 | |
|  * This program is free software, distributed under the terms of
 | |
|  * the GNU General Public License Version 2. See the LICENSE file
 | |
|  * at the top of the source tree.
 | |
|  */
 | |
| 
 | |
| /*
 | |
|  * !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
 | |
|  * !!!!!                               DO NOT EDIT                        !!!!!
 | |
|  * !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
 | |
|  * This file is generated by a mustache template. Please see the original
 | |
|  * template in rest-api-templates/res_stasis_http_resource.c.mustache
 | |
|  */
 | |
| 
 | |
| /*! \file
 | |
|  *
 | |
|  * \brief Asterisk resources
 | |
|  *
 | |
|  * \author David M. Lee, II <dlee@digium.com>
 | |
|  */
 | |
| 
 | |
| /*** MODULEINFO
 | |
| 	<depend type="module">res_stasis_http</depend>
 | |
| 	<depend type="module">res_stasis</depend>
 | |
| 	<support_level>core</support_level>
 | |
|  ***/
 | |
| 
 | |
| #include "asterisk.h"
 | |
| 
 | |
| ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
 | |
| 
 | |
| #include "asterisk/module.h"
 | |
| #include "asterisk/stasis_app.h"
 | |
| #include "stasis_http/resource_asterisk.h"
 | |
| #if defined(AST_DEVMODE)
 | |
| #include "stasis_http/ari_model_validators.h"
 | |
| #endif
 | |
| 
 | |
| /*!
 | |
|  * \brief Parameter parsing callback for /asterisk/info.
 | |
|  * \param get_params GET parameters in the HTTP request.
 | |
|  * \param path_vars Path variables extracted from the request.
 | |
|  * \param headers HTTP headers.
 | |
|  * \param[out] response Response to the HTTP request.
 | |
|  */
 | |
| static void stasis_http_get_asterisk_info_cb(
 | |
| 	struct ast_variable *get_params, struct ast_variable *path_vars,
 | |
| 	struct ast_variable *headers, struct stasis_http_response *response)
 | |
| {
 | |
| #if defined(AST_DEVMODE)
 | |
| 	int is_valid;
 | |
| 	int code;
 | |
| #endif /* AST_DEVMODE */
 | |
| 
 | |
| 	struct ast_get_asterisk_info_args args = {};
 | |
| 	struct ast_variable *i;
 | |
| 
 | |
| 	for (i = get_params; i; i = i->next) {
 | |
| 		if (strcmp(i->name, "only") == 0) {
 | |
| 			args.only = (i->value);
 | |
| 		} else
 | |
| 		{}
 | |
| 	}
 | |
| 	stasis_http_get_asterisk_info(headers, &args, response);
 | |
| #if defined(AST_DEVMODE)
 | |
| 	code = response->response_code;
 | |
| 
 | |
| 	switch (code) {
 | |
| 	case 0: /* Implementation is still a stub, or the code wasn't set */
 | |
| 		is_valid = response->message == NULL;
 | |
| 		break;
 | |
| 	case 500: /* Internal Server Error */
 | |
| 	case 501: /* Not Implemented */
 | |
| 		is_valid = 1;
 | |
| 		break;
 | |
| 	default:
 | |
| 		if (200 <= code && code <= 299) {
 | |
| 			is_valid = ari_validate_asterisk_info(
 | |
| 				response->message);
 | |
| 		} else {
 | |
| 			ast_log(LOG_ERROR, "Invalid error response %d for /asterisk/info\n", code);
 | |
| 			is_valid = 0;
 | |
| 		}
 | |
| 	}
 | |
| 
 | |
| 	if (!is_valid) {
 | |
| 		ast_log(LOG_ERROR, "Response validation failed for /asterisk/info\n");
 | |
| 		stasis_http_response_error(response, 500,
 | |
| 			"Internal Server Error", "Response validation failed");
 | |
| 	}
 | |
| #endif /* AST_DEVMODE */
 | |
| }
 | |
| /*!
 | |
|  * \brief Parameter parsing callback for /asterisk/variable.
 | |
|  * \param get_params GET parameters in the HTTP request.
 | |
|  * \param path_vars Path variables extracted from the request.
 | |
|  * \param headers HTTP headers.
 | |
|  * \param[out] response Response to the HTTP request.
 | |
|  */
 | |
| static void stasis_http_get_global_var_cb(
 | |
| 	struct ast_variable *get_params, struct ast_variable *path_vars,
 | |
| 	struct ast_variable *headers, struct stasis_http_response *response)
 | |
| {
 | |
| #if defined(AST_DEVMODE)
 | |
| 	int is_valid;
 | |
| 	int code;
 | |
| #endif /* AST_DEVMODE */
 | |
| 
 | |
| 	struct ast_get_global_var_args args = {};
 | |
| 	struct ast_variable *i;
 | |
| 
 | |
| 	for (i = get_params; i; i = i->next) {
 | |
| 		if (strcmp(i->name, "variable") == 0) {
 | |
| 			args.variable = (i->value);
 | |
| 		} else
 | |
| 		{}
 | |
| 	}
 | |
| 	stasis_http_get_global_var(headers, &args, response);
 | |
| #if defined(AST_DEVMODE)
 | |
| 	code = response->response_code;
 | |
| 
 | |
| 	switch (code) {
 | |
| 	case 0: /* Implementation is still a stub, or the code wasn't set */
 | |
| 		is_valid = response->message == NULL;
 | |
| 		break;
 | |
| 	case 500: /* Internal Server Error */
 | |
| 	case 501: /* Not Implemented */
 | |
| 		is_valid = 1;
 | |
| 		break;
 | |
| 	default:
 | |
| 		if (200 <= code && code <= 299) {
 | |
| 			is_valid = ari_validate_variable(
 | |
| 				response->message);
 | |
| 		} else {
 | |
| 			ast_log(LOG_ERROR, "Invalid error response %d for /asterisk/variable\n", code);
 | |
| 			is_valid = 0;
 | |
| 		}
 | |
| 	}
 | |
| 
 | |
| 	if (!is_valid) {
 | |
| 		ast_log(LOG_ERROR, "Response validation failed for /asterisk/variable\n");
 | |
| 		stasis_http_response_error(response, 500,
 | |
| 			"Internal Server Error", "Response validation failed");
 | |
| 	}
 | |
| #endif /* AST_DEVMODE */
 | |
| }
 | |
| /*!
 | |
|  * \brief Parameter parsing callback for /asterisk/variable.
 | |
|  * \param get_params GET parameters in the HTTP request.
 | |
|  * \param path_vars Path variables extracted from the request.
 | |
|  * \param headers HTTP headers.
 | |
|  * \param[out] response Response to the HTTP request.
 | |
|  */
 | |
| static void stasis_http_set_global_var_cb(
 | |
| 	struct ast_variable *get_params, struct ast_variable *path_vars,
 | |
| 	struct ast_variable *headers, struct stasis_http_response *response)
 | |
| {
 | |
| #if defined(AST_DEVMODE)
 | |
| 	int is_valid;
 | |
| 	int code;
 | |
| #endif /* AST_DEVMODE */
 | |
| 
 | |
| 	struct ast_set_global_var_args args = {};
 | |
| 	struct ast_variable *i;
 | |
| 
 | |
| 	for (i = get_params; i; i = i->next) {
 | |
| 		if (strcmp(i->name, "variable") == 0) {
 | |
| 			args.variable = (i->value);
 | |
| 		} else
 | |
| 		if (strcmp(i->name, "value") == 0) {
 | |
| 			args.value = (i->value);
 | |
| 		} else
 | |
| 		{}
 | |
| 	}
 | |
| 	stasis_http_set_global_var(headers, &args, response);
 | |
| #if defined(AST_DEVMODE)
 | |
| 	code = response->response_code;
 | |
| 
 | |
| 	switch (code) {
 | |
| 	case 0: /* Implementation is still a stub, or the code wasn't set */
 | |
| 		is_valid = response->message == NULL;
 | |
| 		break;
 | |
| 	case 500: /* Internal Server Error */
 | |
| 	case 501: /* Not Implemented */
 | |
| 		is_valid = 1;
 | |
| 		break;
 | |
| 	default:
 | |
| 		if (200 <= code && code <= 299) {
 | |
| 			is_valid = ari_validate_void(
 | |
| 				response->message);
 | |
| 		} else {
 | |
| 			ast_log(LOG_ERROR, "Invalid error response %d for /asterisk/variable\n", code);
 | |
| 			is_valid = 0;
 | |
| 		}
 | |
| 	}
 | |
| 
 | |
| 	if (!is_valid) {
 | |
| 		ast_log(LOG_ERROR, "Response validation failed for /asterisk/variable\n");
 | |
| 		stasis_http_response_error(response, 500,
 | |
| 			"Internal Server Error", "Response validation failed");
 | |
| 	}
 | |
| #endif /* AST_DEVMODE */
 | |
| }
 | |
| 
 | |
| /*! \brief REST handler for /api-docs/asterisk.{format} */
 | |
| static struct stasis_rest_handlers asterisk_info = {
 | |
| 	.path_segment = "info",
 | |
| 	.callbacks = {
 | |
| 		[AST_HTTP_GET] = stasis_http_get_asterisk_info_cb,
 | |
| 	},
 | |
| 	.num_children = 0,
 | |
| 	.children = {  }
 | |
| };
 | |
| /*! \brief REST handler for /api-docs/asterisk.{format} */
 | |
| static struct stasis_rest_handlers asterisk_variable = {
 | |
| 	.path_segment = "variable",
 | |
| 	.callbacks = {
 | |
| 		[AST_HTTP_GET] = stasis_http_get_global_var_cb,
 | |
| 		[AST_HTTP_POST] = stasis_http_set_global_var_cb,
 | |
| 	},
 | |
| 	.num_children = 0,
 | |
| 	.children = {  }
 | |
| };
 | |
| /*! \brief REST handler for /api-docs/asterisk.{format} */
 | |
| static struct stasis_rest_handlers asterisk = {
 | |
| 	.path_segment = "asterisk",
 | |
| 	.callbacks = {
 | |
| 	},
 | |
| 	.num_children = 2,
 | |
| 	.children = { &asterisk_info,&asterisk_variable, }
 | |
| };
 | |
| 
 | |
| static int load_module(void)
 | |
| {
 | |
| 	int res = 0;
 | |
| 	stasis_app_ref();
 | |
| 	res |= stasis_http_add_handler(&asterisk);
 | |
| 	return res;
 | |
| }
 | |
| 
 | |
| static int unload_module(void)
 | |
| {
 | |
| 	stasis_http_remove_handler(&asterisk);
 | |
| 	stasis_app_unref();
 | |
| 	return 0;
 | |
| }
 | |
| 
 | |
| AST_MODULE_INFO(ASTERISK_GPL_KEY, AST_MODFLAG_DEFAULT, "RESTful API module - Asterisk resources",
 | |
| 	.load = load_module,
 | |
| 	.unload = unload_module,
 | |
| 	.nonoptreq = "res_stasis_http,res_stasis",
 | |
| 	);
 |