Create conference room

POST /conference_room/create
Create conference room
Path parameters
  • access_token

    string

    required

    token to be passed as a header

    minLength: 64

    maxLength: 64

Request body
application/json
  • outbound_caller_id

    string

    required

    outbound_caller_id of conference room.
  • framerate

    integer

    required

    The framerate for video conference room.

    minimum: 5

    maximum: 30

  • bitrate

    integer

    required

    The transmission rate for video conference room. Values: 128 ~ 2048 (it MUST be an integer).
  • layout

    integer

    required

    The number of grids allowed for video conference room. Values : 1, 2, 3, 4, 6 or 9.
  • max_participants

    integer

    required

    The maximum number of participants allowed in the room.
  • subject

    string

    required

    Subject of conference room.
  • mode

    string

    required

    AUDIO for audio conference room; VIDEO for video conference room.

    enum : ['AUDIO', 'VIDEO']

  • unattended

    boolean

    required

    Cancellation of interactive voice .
  • resolution

    string

    required

    The video resolution for video conference room.

    enum : ['QCIF', 'CIF', 'VGA', 'SVGA', 'XVGA', '720P', 'QVGA']

  • room_pin

    string

    required

    PIN for the conference room.
  • extension_number

    string

    required

    Extension for conference room. NOTE: It MUST be a non-existent extension.
  • admin_pin

    string

    required

    PIN for admin of the conference room.
  • language

    string

    required

    Language for prompt in the conference room.

    enum : ['zh_CN', 'en_US', 'da_DK', 'de_DE', 'el_GR', 'en_GB', 'es_ES', 'fr_FR', 'it_IT', 'nl_NL', 'pt_PT', 'pt_BR', 'tr_TR']

Sample Request

                      curl -v -X POST http://127.0.0.1:8990/api/conference_room/create \
                        -H "Content-Type: application/json" \
                        -H "access_token: 4DFCF1D4C30B4D798ECE3AE43769F008" \
                          -d '{}'

Responses

200
Created conference room object
application/json
  • id

    string

    format : int64

Sample Response

                      
{
    "id": 1234
}

update conference room chairman

POST /conference_room/chairman/update
update conference room chairman
Path parameters
  • access_token

    string

    required

    token to be passed as a header

    minLength: 64

    maxLength: 64

Request body
application/json
  • participant_extension

    string

    required

    Extension for conference room. NOTE: It MUST be a non-existent extension.
  • id

    string

    required

    format : int64

Sample Request

                      curl -v -X POST http://127.0.0.1:8990/api/conference_room/chairman/update \
                        -H "Content-Type: application/json" \
                        -H "access_token: 4DFCF1D4C30B4D798ECE3AE43769F008" \
                          -d '{
    "id": 1234
}'

Responses

200
update conference room chairman

Sample Response

Update conference server

POST /conference_server/update
Update conference server
Path parameters
  • access_token

    string

    required

    token to be passed as a header

    minLength: 64

    maxLength: 64

Request body
application/json
  • id

    string

    required

    The userid of the tenant or admin user. Admin user has access to details for his account and other tenantusers, whilst tenant user has access to his account info only.

    format : int64

  • max_participants

    integer

    required

    The maximum number of participants for conference server.
  • max_rooms

    integer

    required

    The maximum number of rooms for conference server.

Sample Request

                      curl -v -X POST http://127.0.0.1:8990/api/conference_server/update \
                        -H "Content-Type: application/json" \
                        -H "access_token: 4DFCF1D4C30B4D798ECE3AE43769F008" \
                          -d '{
    "id": 1234
}'

Responses

200
Successful operation

Sample Response

Destroy conference room

POST /conference_room/destroy
Destroy conference room
Path parameters
  • access_token

    string

    required

    token to be passed as a header

    minLength: 64

    maxLength: 64

  • id

    string

    required

    The ID of conference room.

    format : int64

Sample Request

                      curl -v -X POST http://127.0.0.1:8990/api/conference_room/destroy \
                        -H "Content-Type: application/json" \
                        -H "access_token: 4DFCF1D4C30B4D798ECE3AE43769F008" \

Responses

200
Successful operation
404
User not found
400
Invalid username supplied

Sample Response

Retrieve a collection of conference rooms

GET /conference_room/list
Retrieve a collection of conference rooms
Path parameters
  • access_token

    string

    required

    token to be passed as a header

    minLength: 64

    maxLength: 64

  • pagination

    integer

    required

    The pagination of paging.

    format : int32

  • pagesize

    integer

    required

    The size of paging.
  • sort_by

    string

    optional

    Values include "DEFAULT" and "Optional". Default value will be used when user does not specify value for this field.

    enum : ['DEFAULT', 'OPTIONAL']

Sample Request

                      curl -v -X GET http://127.0.0.1:8990/api/conference_room/list \
                        -H "Content-Type: application/json" \
                        -H "access_token: 4DFCF1D4C30B4D798ECE3AE43769F008" \

Responses

200
Successful operation
application/json
  • pagesize

    integer

  • sort_by

    string

  • pagination

    integer

  • rooms

    array

    Show child attributes
  • count

    integer

Sample Response

                      
{
    "pagesize": 10,
    "sort_by": "DEFAULT",
    "pagination": 8,
    "count": 100
}

Retrieve a collection of conference room participants

GET /conference_room/participants/list
Retrieve a collection of conference room participants
Path parameters
  • access_token

    string

    required

    token to be passed as a header

    minLength: 64

    maxLength: 64

  • id

    string

    required

    The ID of conference room.

    format : int64

Sample Request

                      curl -v -X GET http://127.0.0.1:8990/api/conference_room/participants/list \
                        -H "Content-Type: application/json" \
                        -H "access_token: 4DFCF1D4C30B4D798ECE3AE43769F008" \

Responses

200
Successful operation
application/json
  • --

    object

    Show child attributes

Sample Response

                      
{
    "id": 1234
}

update conference room main_screen

POST /conference_room/main_screen/update
update conference room main_screen
Path parameters
  • access_token

    string

    required

    token to be passed as a header

    minLength: 64

    maxLength: 64

Request body
application/json
  • participant_extension

    string

    required

    Extension for conference room. NOTE: It MUST be a non-existent extension.
  • id

    string

    required

    format : int64

Sample Request

                      curl -v -X POST http://127.0.0.1:8990/api/conference_room/main_screen/update \
                        -H "Content-Type: application/json" \
                        -H "access_token: 4DFCF1D4C30B4D798ECE3AE43769F008" \
                          -d '{
    "id": 1234
}'

Responses

200
update conference room main_screen

Sample Response

Update conference room

POST /conference_room/update
Update conference room
Path parameters
  • access_token

    string

    required

    token to be passed as a header

    minLength: 64

    maxLength: 64

Request body
application/json
  • outbound_caller_id

    string

    required

    outbound_caller_id of conference room.
  • framerate

    integer

    required

    The framerate for video conference room.

    minimum: 5

    maximum: 30

  • bitrate

    integer

    required

    The transmission rate for video conference room. Values: 128 ~ 2048 (it MUST be an integer).
  • layout

    integer

    required

    The number of grids allowed for video conference room. Values : 1, 2, 3, 4, 6 or 9.
  • id

    string

    required

    format : int64

  • subject

    string

    required

    Subject of conference room.
  • unattended

    boolean

    required

    Cancellation of interactive voice .
  • resolution

    string

    required

    The video resolution for video conference room.

    enum : ['QCIF', 'CIF', 'VGA', 'SVGA', 'XVGA', '720P', 'QVGA']

  • muted

    boolean

    required

    muted or unmuted .
  • room_pin

    string

    required

    PIN for the conference room.
  • locked

    boolean

    required

    locked or unlocked .
  • max_participants

    integer

    required

    The maximum number of participants allowed in the room.
  • recording

    boolean

    required

    recording or stop recording .
  • admin_pin

    string

    required

    PIN for admin of the conference room.
  • language

    string

    required

    Language for prompt in the conference room.

    enum : ['zh_CN', 'en_US', 'da_DK', 'de_DE', 'el_GR', 'en_GB', 'es_ES', 'fr_FR', 'it_IT', 'nl_NL', 'pt_PT', 'pt_BR', 'tr_TR']

Sample Request

                      curl -v -X POST http://127.0.0.1:8990/api/conference_room/update \
                        -H "Content-Type: application/json" \
                        -H "access_token: 4DFCF1D4C30B4D798ECE3AE43769F008" \
                          -d '{
    "id": 1234
}'

Responses

200
Updated tenant object

Sample Response

Retrieve conference server

GET /conference_server/show
Retrieve conference server
Path parameters
  • access_token

    string

    required

    token to be passed as a header

    minLength: 64

    maxLength: 64

  • id

    string

    required

    The ID of conference server.

    format : int64

Sample Request

                      curl -v -X GET http://127.0.0.1:8990/api/conference_server/show \
                        -H "Content-Type: application/json" \
                        -H "access_token: 4DFCF1D4C30B4D798ECE3AE43769F008" \

Responses

200
Successful operation
application/json
  • participants_count

    integer

    The number of participants for conference server.
  • cpu_usage

    integer

    The cpu_usage for conference server.
  • type

    string

    Every PortSIP PBX has a built-in conference server with type 1 (default); the new added conference server MUST be typed with "EXTERNAL".

    enum : ['DEFAULT', 'EXTERNAL']

  • max_participants

    integer

    The maximum number of participants for conference server.
  • ipv4

    string

    Host IPV4 address for conference server.
  • port

    integer

    Host port for conference server.
  • max_rooms

    integer

    The maximum number of rooms for conference server.
  • status

    string

    enum : ['ONLINE', 'OFFLINE']

  • memory_usage

    integer

    The memory_usage for conference server.
  • ipv6

    string

    Host IPV6 address for conference server.
  • name

    string

    Name of conference server.
  • rooms_count

    integer

    The number of rooms for conference server.

Sample Response

                      
{}

Retrieve conference room

GET /conference_room/show
Retrieve conference room
Path parameters
  • access_token

    string

    required

    token to be passed as a header

    minLength: 64

    maxLength: 64

  • id

    string

    required

    The ID of conference room.

    format : int64

Sample Request

                      curl -v -X GET http://127.0.0.1:8990/api/conference_room/show \
                        -H "Content-Type: application/json" \
                        -H "access_token: 4DFCF1D4C30B4D798ECE3AE43769F008" \

Responses

200
Successful operation
application/json
  • outbound_caller_id

    string

    outbound_caller_id of conference room.
  • framerate

    integer

    The framerate for video conference room.

    minimum: 5

    maximum: 30

  • max_participants

    integer

    The maximum number of participants allowed in the room.
  • bitrate

    integer

    The transmission rate for video conference room. Values: 128 ~ 2048 (it MUST be an integer).
  • layout

    integer

    The number of grids allowed for video conference room. Values : 1, 2, 3, 4, 6 or 9.
  • id

    string

    format : int64

  • subject

    string

    Subject of conference room.
  • mode

    string

    AUDIO for audio conference room; VIDEO for video conference room.

    enum : ['AUDIO', 'VIDEO']

  • unattended

    boolean

    Cancellation of interactive voice .
  • resolution

    string

    The video resolution for video conference room.

    enum : ['QCIF', 'CIF', 'VGA', 'SVGA', 'XVGA', '720P', 'QVGA']

  • room_pin

    string

    PIN for the conference room.
  • extension_number

    string

    Extension for conference room. NOTE: It MUST be a non-existent extension.
  • admin_pin

    string

    PIN for admin of the conference room.
  • language

    string

    Language for prompt in the conference room.

    enum : ['zh_CN', 'en_US', 'da_DK', 'de_DE', 'el_GR', 'en_GB', 'es_ES', 'fr_FR', 'it_IT', 'nl_NL', 'pt_PT', 'pt_BR', 'tr_TR']

Sample Response

                      
{
    "id": 1234
}

Create conference server

POST /conference_server/create
Create conference server
Path parameters
  • access_token

    string

    required

    token to be passed as a header

    minLength: 64

    maxLength: 64

Request body
application/json
  • port

    integer

    required

    Host port for conference server.
  • max_rooms

    integer

    required

    The maximum number of rooms for conference server.
  • type

    string

    required

    Every PortSIP PBX has a built-in conference server with type 1 (default); the new added conference server MUST be typed with "EXTERNAL".

    enum : ['DEFAULT', 'EXTERNAL']

  • name

    string

    required

    Name of conference server.
  • ipv6

    string

    required

    Host IPV6 address for conference server.
  • max_participants

    integer

    required

    The maximum number of participants for conference server.
  • ipv4

    string

    required

    Host IPV4 address for conference server.

Sample Request

                      curl -v -X POST http://127.0.0.1:8990/api/conference_server/create \
                        -H "Content-Type: application/json" \
                        -H "access_token: 4DFCF1D4C30B4D798ECE3AE43769F008" \
                          -d '{}'

Responses

200
Created conference server
application/json
  • id

    string

    The userid of the tenant or admin user. Admin user has access to details for his account and other tenantusers, whilst tenant user has access to his account info only.

    format : int64

Sample Response

                      
{
    "id": 1234
}

Destroy conference server

POST /conference_server/destroy
Destroy conference server
Path parameters
  • access_token

    string

    required

    token to be passed as a header

    minLength: 64

    maxLength: 64

Request body
application/json
  • id

    string

    required

    The userid of the tenant or admin user. Admin user has access to details for his account and other tenantusers, whilst tenant user has access to his account info only.

    format : int64

Sample Request

                      curl -v -X POST http://127.0.0.1:8990/api/conference_server/destroy \
                        -H "Content-Type: application/json" \
                        -H "access_token: 4DFCF1D4C30B4D798ECE3AE43769F008" \
                          -d '{
    "id": 1234
}'

Responses

200
Successful operation
404
User not found
400
Invalid server id supplied

Sample Response

Retrieve a collection of conference servers

GET /conference_server/list
Retrieve a collection of conference servers
Path parameters
  • access_token

    string

    required

    token to be passed as a header

    minLength: 64

    maxLength: 64

  • pagination

    integer

    required

    The pagination of paging.

    format : int32

  • pagesize

    integer

    required

    The size of paging.
  • sort_by

    string

    optional

    Values include "DEFAULT" and "Optional". Default value will be used when user does not specify value for this field.

    enum : ['DEFAULT', 'OPTIONAL']

Sample Request

                      curl -v -X GET http://127.0.0.1:8990/api/conference_server/list \
                        -H "Content-Type: application/json" \
                        -H "access_token: 4DFCF1D4C30B4D798ECE3AE43769F008" \

Responses

200
Successful operation
application/json
  • pagesize

    integer

  • sort_by

    string

  • servers

    array

    Show child attributes
  • pagination

    integer

  • count

    integer

Sample Response

                      
{
    "pagesize": 10,
    "sort_by": "DEFAULT",
    "pagination": 8,
    "count": 100
}

update conference room participant

POST /conference_room/participants/update
update conference room participant
Path parameters
  • access_token

    string

    required

    token to be passed as a header

    minLength: 64

    maxLength: 64

Request body
application/json
  • op

    string

    required

    enum : ['MUTE/UNMUTE', 'INVITE', 'DELETE']

  • participant_extension

    string

    required

    Extension for conference room. NOTE: It MUST be a non-existent extension.
  • id

    string

    required

    format : int64

Sample Request

                      curl -v -X POST http://127.0.0.1:8990/api/conference_room/participants/update \
                        -H "Content-Type: application/json" \
                        -H "access_token: 4DFCF1D4C30B4D798ECE3AE43769F008" \
                          -d '{
    "id": 1234
}'

Responses

200
update conference room participant

Sample Response