resource_recordings.h 6.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202
  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. /*! \file
  19. *
  20. * \brief Generated file - declares stubs to be implemented in
  21. * res/ari/resource_recordings.c
  22. *
  23. * Recording resources
  24. *
  25. * \author David M. Lee, II <dlee@digium.com>
  26. */
  27. /*
  28. * !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  29. * !!!!! DO NOT EDIT !!!!!
  30. * !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  31. * This file is generated by a mustache template. Please see the original
  32. * template in rest-api-templates/ari_resource.h.mustache
  33. */
  34. #ifndef _ASTERISK_RESOURCE_RECORDINGS_H
  35. #define _ASTERISK_RESOURCE_RECORDINGS_H
  36. #include "asterisk/ari.h"
  37. /*! Argument struct for ast_ari_recordings_list_stored() */
  38. struct ast_ari_recordings_list_stored_args {
  39. };
  40. /*!
  41. * \brief List recordings that are complete.
  42. *
  43. * \param headers HTTP headers
  44. * \param args Swagger parameters
  45. * \param[out] response HTTP response
  46. */
  47. void ast_ari_recordings_list_stored(struct ast_variable *headers, struct ast_ari_recordings_list_stored_args *args, struct ast_ari_response *response);
  48. /*! Argument struct for ast_ari_recordings_get_stored() */
  49. struct ast_ari_recordings_get_stored_args {
  50. /*! The name of the recording */
  51. const char *recording_name;
  52. };
  53. /*!
  54. * \brief Get a stored recording's details.
  55. *
  56. * \param headers HTTP headers
  57. * \param args Swagger parameters
  58. * \param[out] response HTTP response
  59. */
  60. void ast_ari_recordings_get_stored(struct ast_variable *headers, struct ast_ari_recordings_get_stored_args *args, struct ast_ari_response *response);
  61. /*! Argument struct for ast_ari_recordings_delete_stored() */
  62. struct ast_ari_recordings_delete_stored_args {
  63. /*! The name of the recording */
  64. const char *recording_name;
  65. };
  66. /*!
  67. * \brief Delete a stored recording.
  68. *
  69. * \param headers HTTP headers
  70. * \param args Swagger parameters
  71. * \param[out] response HTTP response
  72. */
  73. void ast_ari_recordings_delete_stored(struct ast_variable *headers, struct ast_ari_recordings_delete_stored_args *args, struct ast_ari_response *response);
  74. /*! Argument struct for ast_ari_recordings_copy_stored() */
  75. struct ast_ari_recordings_copy_stored_args {
  76. /*! The name of the recording to copy */
  77. const char *recording_name;
  78. /*! The destination name of the recording */
  79. const char *destination_recording_name;
  80. };
  81. /*!
  82. * \brief Body parsing function for /recordings/stored/{recordingName}/copy.
  83. * \param body The JSON body from which to parse parameters.
  84. * \param[out] args The args structure to parse into.
  85. * \retval zero on success
  86. * \retval non-zero on failure
  87. */
  88. int ast_ari_recordings_copy_stored_parse_body(
  89. struct ast_json *body,
  90. struct ast_ari_recordings_copy_stored_args *args);
  91. /*!
  92. * \brief Copy a stored recording.
  93. *
  94. * \param headers HTTP headers
  95. * \param args Swagger parameters
  96. * \param[out] response HTTP response
  97. */
  98. void ast_ari_recordings_copy_stored(struct ast_variable *headers, struct ast_ari_recordings_copy_stored_args *args, struct ast_ari_response *response);
  99. /*! Argument struct for ast_ari_recordings_get_live() */
  100. struct ast_ari_recordings_get_live_args {
  101. /*! The name of the recording */
  102. const char *recording_name;
  103. };
  104. /*!
  105. * \brief List live recordings.
  106. *
  107. * \param headers HTTP headers
  108. * \param args Swagger parameters
  109. * \param[out] response HTTP response
  110. */
  111. void ast_ari_recordings_get_live(struct ast_variable *headers, struct ast_ari_recordings_get_live_args *args, struct ast_ari_response *response);
  112. /*! Argument struct for ast_ari_recordings_cancel() */
  113. struct ast_ari_recordings_cancel_args {
  114. /*! The name of the recording */
  115. const char *recording_name;
  116. };
  117. /*!
  118. * \brief Stop a live recording and discard it.
  119. *
  120. * \param headers HTTP headers
  121. * \param args Swagger parameters
  122. * \param[out] response HTTP response
  123. */
  124. void ast_ari_recordings_cancel(struct ast_variable *headers, struct ast_ari_recordings_cancel_args *args, struct ast_ari_response *response);
  125. /*! Argument struct for ast_ari_recordings_stop() */
  126. struct ast_ari_recordings_stop_args {
  127. /*! The name of the recording */
  128. const char *recording_name;
  129. };
  130. /*!
  131. * \brief Stop a live recording and store it.
  132. *
  133. * \param headers HTTP headers
  134. * \param args Swagger parameters
  135. * \param[out] response HTTP response
  136. */
  137. void ast_ari_recordings_stop(struct ast_variable *headers, struct ast_ari_recordings_stop_args *args, struct ast_ari_response *response);
  138. /*! Argument struct for ast_ari_recordings_pause() */
  139. struct ast_ari_recordings_pause_args {
  140. /*! The name of the recording */
  141. const char *recording_name;
  142. };
  143. /*!
  144. * \brief Pause a live recording.
  145. *
  146. * Pausing a recording suspends silence detection, which will be restarted when the recording is unpaused. Paused time is not included in the accounting for maxDurationSeconds.
  147. *
  148. * \param headers HTTP headers
  149. * \param args Swagger parameters
  150. * \param[out] response HTTP response
  151. */
  152. void ast_ari_recordings_pause(struct ast_variable *headers, struct ast_ari_recordings_pause_args *args, struct ast_ari_response *response);
  153. /*! Argument struct for ast_ari_recordings_unpause() */
  154. struct ast_ari_recordings_unpause_args {
  155. /*! The name of the recording */
  156. const char *recording_name;
  157. };
  158. /*!
  159. * \brief Unpause a live recording.
  160. *
  161. * \param headers HTTP headers
  162. * \param args Swagger parameters
  163. * \param[out] response HTTP response
  164. */
  165. void ast_ari_recordings_unpause(struct ast_variable *headers, struct ast_ari_recordings_unpause_args *args, struct ast_ari_response *response);
  166. /*! Argument struct for ast_ari_recordings_mute() */
  167. struct ast_ari_recordings_mute_args {
  168. /*! The name of the recording */
  169. const char *recording_name;
  170. };
  171. /*!
  172. * \brief Mute a live recording.
  173. *
  174. * Muting a recording suspends silence detection, which will be restarted when the recording is unmuted.
  175. *
  176. * \param headers HTTP headers
  177. * \param args Swagger parameters
  178. * \param[out] response HTTP response
  179. */
  180. void ast_ari_recordings_mute(struct ast_variable *headers, struct ast_ari_recordings_mute_args *args, struct ast_ari_response *response);
  181. /*! Argument struct for ast_ari_recordings_unmute() */
  182. struct ast_ari_recordings_unmute_args {
  183. /*! The name of the recording */
  184. const char *recording_name;
  185. };
  186. /*!
  187. * \brief Unmute a live recording.
  188. *
  189. * \param headers HTTP headers
  190. * \param args Swagger parameters
  191. * \param[out] response HTTP response
  192. */
  193. void ast_ari_recordings_unmute(struct ast_variable *headers, struct ast_ari_recordings_unmute_args *args, struct ast_ari_response *response);
  194. #endif /* _ASTERISK_RESOURCE_RECORDINGS_H */