Cisco Finesse Desktop Interface API Errors

Error codes for Cisco Finesse are categorized as follows:

  • 4xx—Client-related error

  • 5xx—Server-related error

Each error includes a failure response, error type, error message, and error data. The following is an example of a failure message format:
Code Snippet
Copy
{
   status : 400, apiErrors :
   {
      "errorType": "Bad Request",
      "errorMessage": "Security Exception",
      "errorData": "Error in getting desktop configs."
   }
}

In addition to Cisco Finesse Desktop Interface API errors, a response may return an HTTP error.

HTTP Errors

All HTTP errors are returned as HTTP 1.1 Status Codes. Errors that might be for Finesse-specific events are listed below:
500 Internal Server Error
Finesse Web Services returns 500 if the CTI connection is lost but the loss is not yet detected by automated means.

  • 500 - DB_RUNTIME_EXCEPTION (database error, but the database is thought to be operational)

  • 500 - RUNTIME_EXCEPTION (a non-database error)

  • 500 - AWS_SERVICE_UNAVAILABLE (AWS not operational)

503 Service Unavailable
If Finesse is in PARTIAL_SERVICE or OUT_OF_SERVICE, it returns 503 for all requests. If any dependent service goes down, Finesse goes to OUT_OF_SERVICE state (for example, if the Cisco Finesse Notification Service is down).This error is due to a temporary outage or overloading condition. A retry after several seconds is likely to succeed. For example, the system returns 503 when the system is just starting up and when the system is trying to connect to the CTI server.