API errors (admins)
Natalya Yefimenko avatar
Written by Natalya Yefimenko
Updated over a week ago

When you send an API request to the Affise server, you can get a response with a code other than 200. If you get an API error, it means the request was not sent successfully and your action wasn't performed. Follow the guide below to resolve your issue.

Error responses

Before you start looking for a solution, try the most general steps to avoid an API error:

  • Make sure you use the right API method. For example, not GET instead of POST.

  • If you use the browser to make requests, clear the browser cache and cookies. Also, disable browser extensions and try an incognito mode.

Error message

Description

How to fix

400 - Bad Request

The request you sent to the website server couldn’t be understood, usually, because the JSON or XML body contains an error.

  • Recheck your URL to make sure there are no typing or syntax errors. For long URLs, use an online URL encoder, which automatically detects non-ASCII characters or invalid characters in a URL.

  • If you upload a file using API, try a smaller side of your file.

401 - Token is necessary

The current request requires user authentication. Your API key can be invalid, or you attempted to access the wrong data center.

Use some other API key, and make sure your API belongs to a General manager or the user with enough permissions.

403 - Auth Denied

You are not permitted to access this resource.

Check whether a user has the necessary permissions for the request.

404 - Resource Not Found

The system couldn't find the webpage you tried to reach on the server. It is a client-side error, which means that either the page was removed or you typed in the URL incorrectly.

Recheck your URL if you are sure that a resource exists.

500 - Server error, Please contact your administrator

Something has gone wrong on the website server.

Try the general steps, recheck your URL or address the Customer Support Team.

502 Bad Gateway

The server received an invalid response from an inbound server.

Try the general steps, recheck your URL or address the Customer Support Team.


Please contact the Affise Customer Support team regarding all raised questions via the e-mail: [email protected].

Did this answer your question?