HTTP Response Status Codes

SkyHub uses the default group of HTTP statuses to indicate whether a request was successful or not.

Status Code

Description

HTTP 2xx Codes

Indicate that the request was successful;

HTTP 4xx Codes

indicate that the request contains some incorrect information - incorrect access data, absence of a required field, and so on;

HTTP 5xx Codes

Indicates an error on SkyHub's servers. These are rare, and if you receive this code, you should contact our support.

Erros

Whenever an error occurs, the API will return in the body of the message a JSON with an error message according to the format below:

{error: "error message"}

HTTP Status

The most commonly used HTTP statuses are:

Status

Description

200

Success - The request was processed successfully

201

Created - The request was successfully processed and resulted in a new feature created

204

No content - The request was successfully processed and there is no additional content in the response

400

Malformed request - The request does not conform to the expected format. Check the JSON (body) being sent

401

Not authenticated - Authentication data is incorrect. Check the header of the request for the email and the token

403

Unauthorized - You are trying to access a resource you are not allowed to

404

Not found - You are trying to access a resource that does not exist on SkyHub

406

Format Not Accepted - SkyHub does not support the data format specified in the header (Accept)

415

Media format not supported - SkyHub can not process the uploaded data by its format. Be sure to use the UTF-8 charset (both in the "Content-Type" header and in the request's own body)

422

Semantic error - Despite the request be in the correct format, the data avoid some business rule (eg invalid transition from order status)

429

Exceeded request limit - You have made more requests than allowed in a given resource

500 or 502

Internal error - An error occurred on the SkyHub server when attempting to process the request

503

Service unavailable - SkyHub API is temporarily down

504

Timeout - The request took a long time and can not be processed