Video API Error Handling

The Server API calls make use of JSON Result Code to determine if the API call is successful.

Success JSON

Successful Server API calls will always return JSON with a 0 (zero) Result Code.

{
"result": 0,
….
….
}

Error JSON

If unsuccessful, for whatever reason, Server API calls will return JSON with a non—zero Result Code. This error response will always carry 3 keys, viz.

  • Result Code,
  • Error,
  • Description.

See example below:

{
"result": "Non-Zero Result Code",
"error": "Short reason",
"desc": "Descriptive information about the error / warning"
}

Server API Result Codes

Result Codes

The result codes of the Video Server API are grouped into following categories:

CodeCategoryDescription
1xxInformationRequest received and processed.
2xxSuccessRequest received and accepted.
3xxRedirectionAction required to complete a request.
4xxClient ErrorIllegible request syntax. The request cannot be fulfilled.
5xxServer ErrorThe server failed to complete a legitimate request.

Response Codes for Successful Requests

The Server API response codes for successful requests are described in the below table.

General

Success CodeDescription
0The transaction was successful.

Response Codes for Failed Requests

The Server API response codes for failed requests are described in the below tables.

Rooms

Error CodeDescription
10000The application is not found.
10001The room_id URL parameter is missing.
10002The required data is missing in name (Room Name).
10003An invalid value is passed in settings.scheduled.
10004The required data is missing in settings.scheduled_time.
10005An invalid date or time format is specified for settings.scheduled_time.
10006The value of date or time value specified for settings.scheduled_time is illegible.
10007An invalid value is specified for settings.participants.
10008An invalid value is specified for settings.auto_recording.
10009The key of settings cannot be recognized.
10010The required data is missing in owner_ref.
10011An invalid value is specified for settings.duration.
10012An invalid value is specified for settings.active_talker.
10013An invalid value is specified for settings.wait_moderator.
10014An invalid value is specified for settings.quality.
10015The required data is missing in sip.uri.
10016An invalid value is specified forsettings.adhoc.
10017An invalid value is specified for settings.adhoc
10018Illegible parameter. This parameter is not valid for this Room Type.
10019An invalid value is specified for settings.mode.
10020An illegible parameter is specified for settings.mode.
10021Room quality higher than the application quality is not permitted.
10022An invalid value is specified for settings.moderators.
10023An invalid value is specified for settings.moderators.
10024An illegible value is specified for settings.peep.
10025An illegible value is specified for settings.knock.
10026An invalid value of SIP URI is specified for settings.aor.
10030The update request for the active room is denided.
10106Illegible Request. Update of this Room Type is not allowed.
40001This room is not found.
50000An internal server error has occurred.
50001Failed to create the room.
50002Failed to fetch the list of rooms.
50003Failed to get room information.
50004Failed to delete the room.
50005Failed to get the list of users for the room.

Token

Error CodeDescription
10000The application is not found.
10101The required JSON key is missing for name (User Name).
10102The required JSON key is missing for user_ref.
10103The required JSON key is missing for role.
10104An invalid value is specified for role.
10105The server is busy.
10111Token denied. The conference is over.
10112Token denied. Tried to connect beyond the permissible cut-off time.
10113Token denied. The room is not active.
10114Token denied. The room is full.
40001The room is not found.
40002Token denied. Unauthorized access to the room is not permitted.

CDR

Error CodeDescription
10201The Reason URL parameter is missing for from_date.
10202The URL parameter is missing for to_date.
10203The URL parameter is missing for room-id.
10204The Reason URL parameter is missing for conf-num (Conference Number).