Error processing
SDK can return error codes in response result, send ErrorOccured event and throw SdkException.
ResponseResult
ResponseResult
Result of the request processing by the UnifiedSDK service.
Success codes:
None
- no result, default value that never should come from the service.Ok
- request processed successfully.Unlimited
- current user traffic limit is unlimited.Checking
- backend server returned Checking response.
Client side error codes:
ConnectionTimeout
- cannot connect to the service during timeout.Timeout
- SDK service did not respond within the specified timeout interval (3 minutes).TransportError
- transport error between client and server.TransportNotAuthorized
- the client pipe is not authorized to connect.
Service side error codes:
NotResponding
- VPN node server is not responding.Error
- request processing failed by any reason.TooManyRequests
- SDK service cannot process the command because the same process is in progress or already done. From service this error occurs only for StartVpn and StopVpn requests.NoInternetConnection
- request processing failed because it detected broken internet connection through the primary network adapter.ServiceNotInitialized
- service is not initialized.InvalidUri
- URI parameter has invalid format.
Backend server error codes:
NotAuthorized
- the client passed has an invalid Auth token.DevicesExceeded
- Device limit exceeded.NotFound
- backend server returned 404 error.UserAlreadyExists
- user already exists.LicenseNotFound
- user license was not found.UserAlreadyDisabled
- user is already disabled.InvalidParams
- request-URI has invalid params.CarrierNotFound
- carrier not found.ProcessingError
- request processing.Expired
- session expired.Invalid
- invalid data.Forbidden
- backend server returned 403 error.ServerUnavailable
- backend server is unavailable.SessionsExceed
- session limit exceed.SessionsExceeded
- session limit exceeded.TrafficExceed
- account traffic limit exceed.TrafficExceeded
- account traffic limit exceeded.IntervalTooLong
- interval is too long.IntervalInvalid
- invalid interval.LicenseEditDisabled
- license editing is disabled.EmailNotSet
- account email is not set.EmailNotEnabled
- account email is not enabled.InternalServerError
- backend server returned 500 error.ServerNotFound
- backend request failed with server not found error.InvalidPurchase
- something went wrong with purchase.UserSuspended
- user activity suspended.BadRequest
- backend server returned 400 error.OauthError
- open authenticator error.TooManyRequests
- backend server returned 429 error.InvalidResponse
- invalid response from server (i. e. html instead of json).RequestTimeout
- backend server did not respond within the specified timeout interval.
OperationalError
Service sends operational error codes in ErrorOccured event.
Success codes:
None = 0
- no error. Occurs when service reset the last error on tunnel start.
Сommon errors:
Broken = 181
- tunnel broken. Occurs when connected tunnel unexpectedly broked by unknown reason.Connect = 182
- tunnel connection failed.DcnBlockedBw = 191
- Hydra or OpenVpn tunnel was broken by the server-side because traffic limit exceeded.StartVpnFailed = 8192
- tunnel connection failed. Details can be found in the error message.DisconnectedBeforeConnected = 8193
- tunnel connection failed because tunnel unexpectedly disconnected during connection without any errors.ConnectionTimeout = 8194
- tunnel stucked into Connecting state and aborted by timeout.DisconnectedAfterStart = 8195
- tunnel was connected successfully but unexpectedly disconnected during 10 sec after start without any errors.StoppedAfterStart = 8196
- tunnel client reported Connected but service cannot find active network adapter. Usually occurs when tunnel client crashes right after a successfully connection.TunnelExited = 8197
- tunnel client was unexpectedly terminated.PrimaryNetworkInterfaceChanged = 8198
- primary network interface changed but SDK doesn't support hot-switch between networks. We recommend to reconnect tunnel with the same credentials when this error occured.TrafficLeak = 8199
- traffic is leaking outside the tunnel. Occurs when routing table was changed by the third-side.TunnelBroken = 8200
- occurs when tunnel is connected but traffic is not going through the tunnel during 30 seconds. That means that all health check requests through the tunnel were failed with error.TunnelProcessStartFailed = 8201
- service cannot start tunnel client process by any reason.InvalidConfiguration = 8202
- error occurs when StartVpnRequest validation failed.InvalidTunnelNetworkIndefaceIndex = 8203
- tunnel successfully connected but SDK service cannot determine the tunnel network adapter.StopVpnFailed = 8204
- service cannot stop a tunnel by any reason.WfpSessionCreationFailed = 8205
- error occurs when SDK service cannot create Windows Filtering Platform session for tunnel traffic protection.ConnectionCanceled = 8206
- connection process was successfully canceled by client application request.NoInternetConnection = 8208
- tunnel error occurred and internet connection check failed for the primary network adapter.
Hydra protocol errors:
Config = 180
- Occurs when Hydra configuration is invalid.Internal = 183
- internal Hydra protocol error.ServerAuth = 184
- vpn node server reported authentication error.CannotSend = 185
- internal Hydra client communication issue. Occurs when traffic accumulates into the socket buffer but doesn't go out.TimeSkew = 186
- internal Hydra client communication issue. Can happens only when infrastructure problems occurs .DcnSrvSwitch = 190
- tunnel was broken by the server side reason. Can happens only when infrastructure problems occurs .DcnBlockedAbuse = 192
- tunnel was broken by the server side because abuse traffic detected.DcnBlockedMalware = 193
- tunnel was broken by the server side because malicious traffic is detected.DcnBlockedMisc = 194
- tunnel was broken by the server side with unknown reason.DcnReqByCliapp = 195
- tunnel was broken by the server side.DcnBlockedAuth = 196
- tunnel was broken by the server side with authentication error.DcnSrvFull = 197
- Hydra tunnel was stopped on the server-side when vpn node server is full.InvalidState = 4097
- Hydra cliend error when client cannot process tunnel state correctly.AccessDenied = 4098
- Hydra client permissions error.ComException = 4099
- Hydra client internal error.ComInvalidCastException = 4100
- Hydra client internal error. Occurs when internal COM calls failed by any reason.InvalidFireshieldConfiguration = 8207
- Hydra fireshield configuration is invalid.
Exceptions
SdkException
- SDK service returned general error or transport error occured.
Last updated
Was this helpful?