api v2 error handling

API V2 uses following HTTP status codes to indicate success or failures:

Status code	Explanation
200 OK	Success.
400 Bad Request	Missing or invalid request parameters.
401 Unauthorized	Authorization is required but no API key provided.
403 Forbidden	Invalid API key, no permissions to given resource (e.g. it belongs to another user), resource disabled by administrator.
404 Not Found	Resource does not exists.
405 Method Not Allowed	Resource exists but given method cannot be used on it, e.g. POST to a read-only trading pairs list, using an endpoint that cancels a withdrawal on transaction that is a deposit or internal transfer.
406 Not Acceptable	Request parameters are valid but cannot be accepted, e.g. trying to withdraw coin using valid network, but not associated with given coin, trying to withdraw greater amount than account balance.
409 Conflict	There is a conflict of data that should be unique, e.g. trying to create API key with the same name as existing one.
500 Internal Server Error	Internal error on the Infinex backend. Please try the request again, preferably with some delay.
504 Gateway Timeout	One of the backend services received your request but did not respond in any way. The execution status is unknown and could have been a failure as good as a success. This should be verified preferably after some time has passed.
511 Network Authentication Required	2FA is required. You should repeat the request with identical parameters and 2FA code attached.

For any status except 200, the response body contains the error payload like this:

{
    "error": {
        "code": "INTERNAL_SERVER_ERROR",
        "msg": "Internal server error"
    }
}

The code field contains an unique, constant error code which can be used to catch the specific error.

The msg field contains a human-readable error message, which may be updated by Infinex developers without any notice, so it should not be parsed or used for any purposes other than displaying it to the user in unmodified form.