Error Handling |
This topic contains the following sections:
Error codes are grouped in the following sections:
Error information is stored in the following data schema. The format of the error response depends on the type of request.
If you are building an application that depends on TDE operations, and it needs to make a decision based on receiving a specific error, then you must use the ErrorCode rather than the ErrorText in your code. The ErrorCode is a value that applications can reliably use to handle error responses, while the ErrorText is a human readable string not suitable for application consumption.
ErrorResponse
The ErrorResponse is the top level response returned for SOAP and REST calls.
Member | Type | Purpose |
---|---|---|
ErrorInfo | ErrorInfo[] | Describes all errors that occurred. |
ErrorText | string | Human readable message of the errors. |
ErrorInfo
ErrorInfo is either returned as part of the ErrorResponse array for SOAP and REST calls, or it is the top level response for errors that occur when using the web service to work with TDE templates.
Member | Type | Purpose |
---|---|---|
ErrorCode | string | Error code for the error. |
ErrorText | string | Human readable description of the error. |
ErrorParameters | ErrorParameter[] | If applicable, a list of parameters associated with the error. |
ErrorParameters
The ErrorParameters array is only returned as part of ErrorInfo. It provides additional information about the error if it is available, such as the parameter and value that caused the error.
Member | Type | Purpose |
---|---|---|
Parameter | string | Name of the parameter that was in error. |
Value | string | Value of the parameter that was in error. |