The following page describes the errors you might get when calling Topsort's /auctions and /events endpoints. A very general classification of these is by their HTTP status code:
4xx status codes mean there was a problem with the request sent to Topsort.
5xx status codes indicates a problem with Topsort's service.
Both error types return a JSON array of error objects. Each error object has these fields:
A short string uniquely identifying the problem.
A link to this documentation providing more information about the error.
Optional. If present, human-readable explanation of or details about the error. The string for a given error may change over time; code should not parse or dispatch based on particular values for this field.
The request could not be parsed. Please check the OpenAPI specification for the correct request schema.
The request is empty. Please check the OpenAPI specification for the correct request schema.
The server has encountered a problem. This is an unexpected problem. Our team moves fast and usually fixes any cause for this error in a few hours.
The API key in the authorization header is missing, invalid or expired. Please check the Authentication section for more details.
The auction ID does not correspond to an auction. Please make sure that an auction ID returned by /auction is passed in the request.
The event type must be one of: "Impression", "Click", "Purchase".
One or more invalid promotion types in slots field.
The session object must contain a non empty sessionId value. See Session information for more details.
Missing required aspect ratio for banner ads.
You must specify at least one auction.
Missing required context. Either a category, a list of products or a search query must be specified.
Missing required placement or placement.page field.
An auction must request slots for at least one promotion type.
Missing required purchasedAt field.
Missing required session field.
Missing required slots field.
At least one product must be specified.
At least one item must be purchased.
One of the purchase items had a quantity of less or equal than zero.
The provided resolved bid ID does not match an internal record.
At lease one impression must be included.
An auction must specify at least one slot.
At most 5 auctions can be run in parallel. If you need to increase the number please contact your KAM.