Shipl uses conventional HTTP response codes to indicate the success or failure of an API request. In general: Codes in the 2xx range indicate success. Codes in the 4xx range indicate an error that failed given the information provided (e.g., a required parameter was omitted, a charge failed, etc.). Codes in the 5xx range indicate an error with Shipl's servers (these are rare).
Some 4xx errors that could be handled programmatically include an error code that briefly explains the error reported.
OK -- Everything worked as expected.
Bad Request -- The request was unacceptable, often due to missing a required parameter or not JSON.
Unauthorized -- No auth token
Forbidden -- Auth token missing or invalid.
Not Found -- The specified path could not be found.
Method Not Allowed -- You tried to access an endpoint with an invalid method.
Too Many Requests -- You're requesting too many transactions! Slow down!
Internal Server Error -- We had a problem with our server. Try again later.
Service Unavailable -- We're temporarily offline for maintenance. Please try again later.