Asterisk Conference Room Configuration

Last modified by ryanp on 2021/09/10 23:34

This page is currently being written. Although the information below is probably accurate, it may not be complete or may have errors.

The information on this page applies to iSymphony 3.1+.

Description

The Asterisk conference room REST resource allows access to the configuration for conference rooms in the system. This resource allows adding, removing, and updating of conference rooms in the system.

On this page:

The [toc] macro is a standalone macro and it cannot be used inline. Click on this message for details.
This macro generates standalone content. As a consequence you need to make sure to use a syntax that separates your macro from the content before and after it so that it's on a line by itself. For example in XWiki Syntax 2.0+ this means having 2 newline characters (a.k.a line breaks) separating your macro from the content before and after it.

Root Resource Path

communication_manager/rest/config/asterisk/{coreServerId}/conferenceRooms

JSON Representation

{
"id": "066a6359-0ff1-49e5-83aa-52083dfbbddb",
"name": "Main",
"identifier": "650",
"destinationExtension": "650",
"destinationContext": "from-internal",
"permissionDisplayName": "Main <650>",
"permissionId": "066a6359-0ff1-49e5-83aa-52083dfbbddb"
}

Property	Type	Description
id	String	Configuration id of the conference room.
name	String	The display name of the conference room.
identifier	String	The Asterisk identifier of the conference room.
destinationExtension	String	The extension used to call the conference room from the panel.
destinationContext	String	The context used to call the conference room from the panel.
displayName	String	The display name for the user.
permissionDisplayName	String	Display name of the conference room in the permission system.
permissionId	String	Permission id of the conference room.

Resource Paths

communication_manager/rest/config/asterisk/{coreServerId}/conferenceRooms
Description	Accesses all the conference rooms in the core server.
GET	Gets all the configuration for all the conference rooms in the system.
POST	Adds a conference room to the configuration. Errors: 409 'A conferenceRoom with the given id already exists.': Returned if a conference room with the given id already exists. 409 'A conferenceRoom with the given identifier already exists.': Returned if a conference room with the given identifier already exists. 412 'No identifier provided.': Returned if no identifier was provided. 412 'No name provided.': Returned if no name was provided. 412 'No destinationContext provided.': Returned if no destination context was provided. 412 'No destinationExtension provided.': Returned if no destination extension was provided.

communication_manager/rest/config/asterisk/{coreServerId}/conferenceRooms/{conferenceRoomId}
Description	Accesses the configuration of a specific conference room. Parameters: conferenceRoomId: The configuration id of the conference room.
GET	Gets the configuration of the specified conference room. Errors: 404 'A conference room with the given id does not exist': Returned if no conference room exists with the given id.
PUT	Updates the specified conference room configuration. Errors: 404 'A conference room with the given id does not exist': Returned if no conference room exists with the given id. 409 'A conference room with the given identifier already exists.': Returned if a conference room with the given identifier already exists. 412 'No identifier provided.': Returned if no identifier was provided. 412 'No name provided.': Returned if no name was provided. 412 'No destinationContext provided.': Returned if no destination context was provided. 412 'No destinationExtension provided.': Returned if no destination extension was provided.
DELETE	Deletes the specified conference room configuration. Errors: 404 'A queue with the given id does not exist': Returned if no queue exists with the given id.

Curl Examples

Get all conference rooms in a core server

curl --user manager:manag3rpa55word -k -i -H "Accept: application/json" http://localhost:58080/communication_manager/rest/config/asterisk/ee828da8-5ee6-412d-82ac-1273f598659d/conferenceRooms

Get the configuration for a specific conference room

curl --user manager:manag3rpa55word -k -i -H "Accept: application/json" http://localhost:58080/communication_manager/rest/config/asterisk/ee828da8-5ee6-412d-82ac-1273f598659d/conferenceRooms/56cf70a3-1ee0-4b09-8f40-297430eeeddf

Add a new conference room

curl --user manager:manag3rpa55word -k -i -H "Content-Type: application/json" -H "Accept: application/json" -X POST -d '{"id":"066a6359-0ff1-49e5-83aa-52083dfbbddb","name":"Main","identifier":"650","destinationExtension":"650","destinationContext":"from-internal"}' http://localhost:58080/communication_manager/rest/config/asterisk/ee828da8-5ee6-412d-82ac-1273f598659d/conferenceRooms

Delete a conference room

curl --user manager:manag3rpa55word -k -i -X DELETE http://localhost:58080/communication_manager/rest/config/asterisk/ee828da8-5ee6-412d-82ac-1273f598659d/conferenceRooms/56cf70a3-1ee0-4b09-8f40-297430eeeddf

Update a conference room

curl --user manager:manag3rpa55word -k -i -H "Content-Type: application/json" -H "Accept: application/json" -X PUT -d '{"id":"066a6359-0ff1-49e5-83aa-52083dfbbddb","name":"Main New","identifier":"650","destinationExtension":"650","destinationContext":"from-internal"}' http://localhost:58080/communication_manager/rest/config/asterisk/ee828da8-5ee6-412d-82ac-1273f598659d/conferenceRooms/56cf70a3-1ee0-4b09-8f40-297430eeeddf