From aa370d6105e4d69fc6fc6c72baecfbf5d51534ef Mon Sep 17 00:00:00 2001 From: Sam Galarneau Date: Thu, 3 Jul 2014 16:14:39 +0000 Subject: ARI: Improvements to body parameters documentation The variables body parameter under the originate and originate with id operations of the channel resource showed invalid JSON in its description. The variables body parameter under the userEvent operation of the event resource made no mention that the custom key/value pairs should be wrapped in a variables key in order to be added to the custom user event. ASTERISK-23975 #close Review: https://reviewboard.asterisk.org/r/3692/ ........ Merged revisions 417878 from http://svn.asterisk.org/svn/asterisk/branches/12 git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@417879 65c4cc65-6c06-0410-ace0-fbb531ad65f3 --- res/ari/resource_channels.h | 4 ++-- res/ari/resource_events.h | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) (limited to 'res') diff --git a/res/ari/resource_channels.h b/res/ari/resource_channels.h index 315ec7868..104e1bdb3 100644 --- a/res/ari/resource_channels.h +++ b/res/ari/resource_channels.h @@ -68,7 +68,7 @@ struct ast_ari_channels_originate_args { const char *caller_id; /*! Timeout (in seconds) before giving up dialing, or -1 for no timeout. */ int timeout; - /*! The 'variables' key in the body object holds variable key/value pairs to set on the channel on creation. Other keys in the body object are interpreted as query parameters. Ex. { 'endpoint': 'SIP/Alice', 'variables': { 'CALLERID(name)': 'Alice' } } */ + /*! The "variables" key in the body object holds variable key/value pairs to set on the channel on creation. Other keys in the body object are interpreted as query parameters. Ex. { "endpoint": "SIP/Alice", "variables": { "CALLERID(name)": "Alice" } } */ struct ast_json *variables; /*! The unique id to assign the channel on creation. */ const char *channel_id; @@ -129,7 +129,7 @@ struct ast_ari_channels_originate_with_id_args { const char *caller_id; /*! Timeout (in seconds) before giving up dialing, or -1 for no timeout. */ int timeout; - /*! The 'variables' key in the body object holds variable key/value pairs to set on the channel on creation. Other keys in the body object are interpreted as query parameters. Ex. { 'endpoint': 'SIP/Alice', 'variables': { 'CALLERID(name)': 'Alice' } } */ + /*! The "variables" key in the body object holds variable key/value pairs to set on the channel on creation. Other keys in the body object are interpreted as query parameters. Ex. { "endpoint": "SIP/Alice", "variables": { "CALLERID(name)": "Alice" } } */ struct ast_json *variables; /*! The unique id to assign the second channel when using local channels. */ const char *other_channel_id; diff --git a/res/ari/resource_events.h b/res/ari/resource_events.h index 021a59636..646cf9bfc 100644 --- a/res/ari/resource_events.h +++ b/res/ari/resource_events.h @@ -68,7 +68,7 @@ struct ast_ari_events_user_event_args { size_t source_count; /*! Parsing context for source. */ char *source_parse; - /*! custom key/value pairs added to the user event */ + /*! The "variables" key in the body object holds custom key/value pairs to add to the user event. Ex. { "variables": { "key": "value" } } */ struct ast_json *variables; }; /*! -- cgit v1.2.3