Swagger allows parameters to be specified as 'allowMultiple', meaning that the parameter may be specified as a comma separated list of values. I had written some of the API docs using that, but promptly forgot about implementing it. This patch finally fills in that gap. The codegen template was updated to represent 'allowMultiple' fields as array/size fields in the _args structs. It also parses the comma separated list using ast_app_separate_args(), so quoted strings in the argument will be handled properly. Review: https://reviewboard.asterisk.org/r/2698/ git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@396122 65c4cc65-6c06-0410-ace0-fbb531ad65f3
97 lines
2.3 KiB
Text
97 lines
2.3 KiB
Text
{{#api_declaration}}
|
|
/*
|
|
* Asterisk -- An open source telephony toolkit.
|
|
*
|
|
* {{{copyright}}}
|
|
*
|
|
* {{{author}}}
|
|
*
|
|
* 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.
|
|
*/
|
|
|
|
/*! \file
|
|
*
|
|
* \brief Generated file - declares stubs to be implemented in
|
|
* res/ari/resource_{{name}}.c
|
|
*
|
|
* {{{description}}}
|
|
*
|
|
* \author {{{author}}}
|
|
*/
|
|
|
|
/*
|
|
{{> do-not-edit}}
|
|
* This file is generated by a mustache template. Please see the original
|
|
* template in rest-api-templates/ari_resource.h.mustache
|
|
*/
|
|
|
|
#ifndef _ASTERISK_RESOURCE_{{name_caps}}_H
|
|
#define _ASTERISK_RESOURCE_{{name_caps}}_H
|
|
|
|
#include "asterisk/ari.h"
|
|
|
|
{{#apis}}
|
|
{{#operations}}
|
|
/*! \brief Argument struct for ast_ari_{{c_nickname}}() */
|
|
struct ast_{{c_nickname}}_args {
|
|
{{#parameters}}
|
|
{{#description}}
|
|
{{/description}}
|
|
{{^allow_multiple}}
|
|
{{#description}}
|
|
/*! \brief {{{description}}} */
|
|
{{/description}}
|
|
{{c_data_type}}{{c_space}}{{c_name}};
|
|
{{/allow_multiple}}
|
|
{{#allow_multiple}}
|
|
/*! \brief Array of {{{description}}} */
|
|
{{c_data_type}}{{c_space}}*{{c_name}};
|
|
/*! \brief Length of {{c_name}} array. */
|
|
size_t {{c_name}}_count;
|
|
/*! \brief Parsing context for {{c_name}}. */
|
|
char *{{c_name}}_parse;
|
|
{{/allow_multiple}}
|
|
{{/parameters}}
|
|
};
|
|
{{#is_req}}
|
|
/*!
|
|
* \brief {{summary}}
|
|
{{#notes}}
|
|
*
|
|
* {{{notes}}}
|
|
{{/notes}}
|
|
*
|
|
* \param headers HTTP headers
|
|
* \param args Swagger parameters
|
|
* \param[out] response HTTP response
|
|
*/
|
|
void ast_ari_{{c_nickname}}(struct ast_variable *headers, struct ast_{{c_nickname}}_args *args, struct ast_ari_response *response);
|
|
{{/is_req}}
|
|
{{#is_websocket}}
|
|
/*!
|
|
* \brief {{summary}}
|
|
{{#notes}}
|
|
*
|
|
* {{{notes}}}
|
|
{{/notes}}
|
|
*
|
|
* \param session ARI WebSocket.
|
|
* \param headers HTTP headers.
|
|
* \param args Swagger parameters.
|
|
*/
|
|
void ast_ari_websocket_{{c_nickname}}(struct ast_ari_websocket_session *session, struct ast_variable *headers, struct ast_{{c_nickname}}_args *args);
|
|
{{/is_websocket}}
|
|
{{/operations}}
|
|
{{/apis}}
|
|
|
|
#endif /* _ASTERISK_RESOURCE_{{name_caps}}_H */
|
|
{{/api_declaration}}
|