The RESTful API for
matteroTM employs the use of the
HTTP Status Codes
listed below, to indicate the success or failure for a particular request. Generally speaking, 2xx
indicates
success and are ideal. Codes in the 4xx
range indicate that not all information required has been
provided, and codes in the 5xx
range indicate issues on the end of matteroTM.
Code | Summary | Description |
---|---|---|
200 | Ok | The request was successful with a body in the response. |
204 | No Content | The request was successful, no body in response. |
400 | Bad Request | The request failed validation checks. |
401 | Unauthorized | Failed authentication check. |
402 | Payment Required | Payment is required to use this endpoint. |
403 | Forbidden | Failed authorization check. |
404 | Not Found | Either couldn't find the endpoint or the query's entity. |
415 | Unsupported Media Type | Incorrect body format, matteroTM only accepts application/json mime-types. |
429 | Too Many Requests | You hit our rate limiter, spread out your requests. |
500 | Internal Server Error | An unexpected error occured on our end. |
502 | Bad Gateway | The server was acting as a gateway or proxy and received an invalid response from the upstream server. |
503 | Service Unavailable | The server cannot handle the request (because it is overloaded or down for maintenance). Generally, this is a temporary state. |
504 | Gateway Timeout | The server was acting as a gateway or proxy and did not receive a timely response from the upstream server. |