Management API Trouble Shooter



The Queue-Fair Management REST API

To use the API and see full API documentation, see https://api.queue-fair.net. You can find more information about how Queue-Fair works in the Technical Guide, or the Queue-Fair Portal > Help section.

Error Model

The API will respond with a 200 OK if your request succeeds. If your request fails, it will respond with a 207 error code on most calls, however occasionally other error codes may be set for the HTTP response itself. The error message has its own "code" property, which is more useful than the "207" code returned by the HTTP response itself. The API can only be accessed over HTTPs, and SHOULD only respond with application/json but MAY occasionally respond with HTML if JSON cannot be produced.

Errors are usually due to poor formatting of input. The API is tolerant of whitespace in JSON but is case sensitive. All requests must be UTF-8 encoded, and text values should be appropriately JSON-escaped.

Error message codes

The list below shows the error codes that may be returned by our API code. The underlying framework may also return other codes under some circumstances.

LocationCodeMeaning
Response200Your request succeeded.
Response207Your request could not be processed successfully. Check the "code" of the error message for further details.
Response404The path of your request does not correspond to an API function.
Message202Your request was processed successfully but left the system unchanged. Make Live is not performed.
Message400Bad input data (value) that could not be processed.
Message404The requested object does not exist.
Message405The requested operation must be performed by Queue-Fair support.
Message413The file you tried to upload exceeded the 500k file size limit.
Message500Internal Server Error. See the error message for further details.

Exceptions and Errors

The list below shows the exceptions that may be returned by our API code. The underlying framework may also return other exceptions or errors under some circumstances.

ExceptionMeaning
NoChangesExceptionYour request was processed successfully but left the system unchanged. Make Live is not performed.
InvalidArgumentExceptionBad input data (value) that could not be processed.
UnexpectedValueExceptionInput data that should not be present, is too short or null, or collides with an existing value.
DatabaseExceptionYour changes could not be written to the database.
RuntimeExceptionYour changes were written to the database but could not be pushed to the live Queue Servers or Google Cloud. Try hitting Make Live in the Portal.
LengthExceptionThe input data was too large.
BadMethodCallExceptionThe operation must be performed by Queue-Fair support (only thrown if you try to change your account system name).

Want to know how Queue-Fair works?