๐Ÿ› ๏ธ Troubleshooting

It happens.

It is crucial to pay close attention to the error code and contents of the response body when encountering an error from the Apicbase API. These details provide valuable insights into the error's nature, the reason for the request failure, and how to resolve it.

Below are some of the most common error codes to watch out for:

  • 400 Bad Request - Your payload is invalid in some way. This happens when your request is missing a required parameter, or when some parameter is not in the expected format, such as specifying an object where a list is expected.
  • 401 Unauthorized - This means that your access token is absent from the Authorization header or expired, and you need to make sure that it's present and/or refresh it.
  • 403 Forbidden - This means that you are not allowed to access the desired resource or to perform the desired action. This can be because your token does not have the necessary scopes, or because the user that you're logged in as does not have the required permissions.
  • 404 Not Found - You can get this when referencing an ID for an object that does not exist. The IDs used in the API are sometimes different from other types of IDs you can see in the user interface (PO number, VAT number, recipe's reference number...). This can also happen if your application is operating on a library different from the one that you expect.
  • 429 Too Many Requests - Your application got rate limited, and you will have to wait for a bit before you're allowed to make more requests.
  • 500 Internal Server Error - We either did not foresee this error, or something wrong and unexpected happened! Please reach out to [email protected] if this happens.