Error Handling
Every error produced by this library is of a WMTError type. This error contains the following information:
reason - A specific reason, why the error happened. For more information see WMTErrorReason chapter.nestedError - Original exception/error (if available) that caused this error.httpStatusCode - If the error is networking error, this property will provide HTTP status code of the error.httpUrlResponse - If the error is networking errror, this will hold original HTTP response that was recieved from the backend.restApiError - If the error is a “well-known” API error, it will be filled here. For more information see Known REST API Error codes.networkIsNotReachable - Convenience property, informs about a state where the network is not available (based on the error type).networkConnectionIsNotTrusted - Convenience property, informs about a TLS error.powerAuthErrorResponse - If the error was caused by the PowerAuth error, you can retrieve it here.powerAuthRestApiErrorCode - If the error was caused by the PowerAuth error, the error code of the original error will be available here.
Known REST API Error codes
| Error Code |
Description |
authenticationFailure |
General authentication failure (wrong password, wrong activation state, etc…) |
invalidRequest |
Invalid request sent - missing request object in the request |
invalidActivation |
Activation is not valid (it is different from configured activation) |
pushRegistrationFailed |
Error code for a situation when registration to push notification fails |
operationAlreadyFinished |
Operation is already finished |
operationAlreadyFailed |
Operation is already failed |
operationAlreadyCancelled |
Operation is canceled |
operationExpired |
Operation is expired |
WMTErrorReason
Each WMTError has a reason property why the error was created. Such reason can be useful when you’re creating for example a general error handling or reporting, or when you’re debugging the code.
Library defined options
General errors
| Option Name |
Description |
unknown |
Unknown fallback reason |
missingActivation |
PowerAuth instance is missing an activation. |
Network errors
| Option Name | Description |
|—|—|
|network_unknown|When unknown (usually logic error) happened during networking.|
|network_generic|When generic networking error happened.|
|network_errorStatusCode|HTTP response code was different than 200 (success).
|network_invalidResponseObject|An unexpected response from the server.|
|network_invalidRequestObject|Request is not valid. Such an object is not sent to the server.|
|network_signError|When the signing of the request failed.|
|network_timeOut|Request timed out|
|network_noInternetConnection|Not connected to the internet.|
|network_badServerResponse|Bad (malformed) HTTP server response. Probably an unexpected HTTP server error.|
|network_sslError`|SSL error. For detailed information, see the attached error object when available.|
Operation errors
| Option Name |
Description |
operations_invalidActivation |
Request needs valid powerauth activation. |
operations_alreadyFailed |
Operation is already in a failed state. |
operations_alreadyFinished |
Operation is already in a finished state. |
operations_alreadyCanceled |
Operation is already in a canceled state. |
operations_alreadyRejected |
Operation expired. |
operations_authExpired |
Operation has expired when trying to approve the operation. |
operations_rejectExpired |
Operation has expired when trying to reject the operation. |
operations_QROperationFailed |
Couldn’t sign QR operation. |
Push errors
| Option Name |
Description |
push_alreadyRegistering |
Push registration is already in progress. |
