Skip to content

Errors ​

Every error skapi-py raises is a SkapiError with two fields:

  • code: a short name you can check in code, such as INVALID_PARAMETER.
  • message: what went wrong, in plain words.
python
from skapi import Skapi, SkapiError

skapi = Skapi("<Project ID>")

try:
    skapi.login("user@example.com", "wrong password")
except SkapiError as err:
    print(err.code)     # INCORRECT_USERNAME_OR_PASSWORD
    print(err.message)  # Incorrect username or password.

The codes are the same ones skapi-js uses, so a check written for one works for the other.

Common codes ​

codemeaning
INVALID_PARAMETERA value you passed is missing, the wrong type, or out of range. The message names it. Nothing was sent.
INVALID_REQUESTThe call is not allowed in this state, for example User login is required.
NOT_EXISTSThe record, file, account or project does not exist.
EXISTSIt already exists, for example an account with that e-mail.
INCORRECT_USERNAME_OR_PASSWORDWrong e-mail, username or password.
MFA_REQUIREDThe password was right and the account has two-step login on: call verify_mfa() with the code. See Two-Step Login.
INVALID_CODEWrong authenticator code. Try the next one.
SIGNUP_CONFIRMATION_NEEDEDThe user has not confirmed their signup yet.
USER_IS_DISABLEDThe account is disabled. See User Profile.
REQUIRE_LOGINThe project only lets signed-in users read its database.
REQUEST_EXCEEDToo many attempts. Wait and try again.
TOO_MANY_REQUESTSThe server kept answering "too many requests" after 6 automatic retries.
NETWORK_ERRORNo answer came back. The user stays signed in; try again when the network is back.
ERRORAnything else. The message says what happened.

Retries ​

skapi-py retries on its own when the server asks it to slow down (it waits as long as the server says, up to 6 times), and when a token refresh fails for lack of network (up to about 6 seconds). Other errors are raised at once.

skapi-py 2.4.0