asterisk/res/ari/resource_device_states.h

107 lines
3.5 KiB
C
Raw Normal View History

2023-05-25 18:45:57 +00:00
/*
* Asterisk -- An open source telephony toolkit.
*
* Copyright (C) 2012 - 2013, Digium, Inc.
*
* Kevin Harwell <kharwell@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.
*/
/*! \file
*
* \brief Generated file - declares stubs to be implemented in
* res/ari/resource_deviceStates.c
*
* Device state resources
*
* \author Kevin Harwell <kharwell@digium.com>
*/
/*
* !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
* !!!!! 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_DEVICESTATES_H
#define _ASTERISK_RESOURCE_DEVICESTATES_H
#include "asterisk/ari.h"
/*! Argument struct for ast_ari_device_states_list() */
struct ast_ari_device_states_list_args {
};
/*!
* \brief List all ARI controlled device states.
*
* \param headers HTTP headers
* \param args Swagger parameters
* \param[out] response HTTP response
*/
void ast_ari_device_states_list(struct ast_variable *headers, struct ast_ari_device_states_list_args *args, struct ast_ari_response *response);
/*! Argument struct for ast_ari_device_states_get() */
struct ast_ari_device_states_get_args {
/*! Name of the device */
const char *device_name;
};
/*!
* \brief Retrieve the current state of a device.
*
* \param headers HTTP headers
* \param args Swagger parameters
* \param[out] response HTTP response
*/
void ast_ari_device_states_get(struct ast_variable *headers, struct ast_ari_device_states_get_args *args, struct ast_ari_response *response);
/*! Argument struct for ast_ari_device_states_update() */
struct ast_ari_device_states_update_args {
/*! Name of the device */
const char *device_name;
/*! Device state value */
const char *device_state;
};
/*!
* \brief Body parsing function for /deviceStates/{deviceName}.
* \param body The JSON body from which to parse parameters.
* \param[out] args The args structure to parse into.
* \retval zero on success
* \retval non-zero on failure
*/
int ast_ari_device_states_update_parse_body(
struct ast_json *body,
struct ast_ari_device_states_update_args *args);
/*!
* \brief Change the state of a device controlled by ARI. (Note - implicitly creates the device state).
*
* \param headers HTTP headers
* \param args Swagger parameters
* \param[out] response HTTP response
*/
void ast_ari_device_states_update(struct ast_variable *headers, struct ast_ari_device_states_update_args *args, struct ast_ari_response *response);
/*! Argument struct for ast_ari_device_states_delete() */
struct ast_ari_device_states_delete_args {
/*! Name of the device */
const char *device_name;
};
/*!
* \brief Destroy a device-state controlled by ARI.
*
* \param headers HTTP headers
* \param args Swagger parameters
* \param[out] response HTTP response
*/
void ast_ari_device_states_delete(struct ast_variable *headers, struct ast_ari_device_states_delete_args *args, struct ast_ari_response *response);
#endif /* _ASTERISK_RESOURCE_DEVICESTATES_H */