The Maileon API returns an HTTP status code to each request. For most error cases, the response body is an XML errors document containing more details.
Successful 2XX
1 |
<strong>200 OK</strong> – The request has succeeded. |
1 |
<strong>201 Created</strong> – The request has been fulfilled and resulted in a new resource being created. |
Client Error 4XX
1 |
<strong>400 Bad Request</strong> – The request could not be understood by the server due to malformed syntax. The client should not repeat the request without modifications. |
1 |
<strong>401 Unauthorized</strong> – The API Key is missing or invalid or has expired. API Keys of blocked newsletter accounts will not be authorized. |
1 |
<strong>403 Forbidden</strong> – The API Key has no privileges for the requested HTTP method. |
1 |
<strong>404 Not Found</strong> – The requested resource was not found. |
1 |
<strong>405 Method Not Allowed</strong> – The method specified in the request line is not allowed for the resource identified by the request URI. |
Server Error 5XX
1 |
<strong>500 Internal Server Error</strong> – The Maileon server encountered an error. |
Example Error Report
Status: 400 Bad Request Content-Type: application/vnd.maileon.api+xml <?xml version="1.0" encoding="UTF-8"?> <error> <message>page_size must not exceed 1000 but was 200000</message> </error>