HTTP status codes are used to indicate whether or not an operation succeeded. The status code of a response should always be checked first.
The following codes may be expected:
- 200 OK: The requested operation succeeded. Any result can be found in the response body.
- 400 Bad Request: This can indicate a number of things: bad data may be sent, a required field is missing or some invalid value was provided. In any case: it indicates that something was wrong with the request.
- 401 Unauthorized: The authorization header is missing. See authentication for more details on how to properly sign a request.
- 403 Forbidden: The API key used for this request does not have the correct permissions to execute the requested operation.
- 429 Rate Limit Exceeded: Happens when the order creation rate limit has been exceeded. See rate limiting for more details on how to handle rate limited requests.
- 500 Internal Server Error: An error within Ticketmatic. These should never happen and are collected / reported automatically. Nevertheless: it is always very helpful if you contact support when a server error occurs, it greatly helps us in debugging the issue.
Client libraries may hide this information and instead use the error reporting mechanism for the specific language. For example: in PHP an exception is thrown, in Go there’s an extra error return value.