HTTP Responses
The Big Tickets API uses the standard HTTP response codes to respond to requests. The codes that can be returned by the API are as follows:
- 400 Bad Request - e.g. malformed request syntax, missing parameter
- 401 Unauthorized - e.g. invalid secret key
- 403 Forbidden - e.g. account locked, insufficient permissions
- 404 Not Found - e.g. no event found using the key passed in
HTTP response codes 400 and 404 will return a JSON formatted response body. The response body for HTTP response codes 401 and 403 will be empty. An example of a response body for an invalid request can be found below:
The response body will always contain a status and at least one message in errors. There may also be warning messages associated with it (i.e. warnings).
{
"status": 404,
"warnings": [],
"errors": [
{
"code": "EVENT_NOT_FOUND",
"message": "The event key used was not found."
}
]
}