Errors
Successful Requests
The web services return a HTTP 2xx response code when the request was successful.
HTTP Success Codes:
| Success Code | Message | Description |
|---|---|---|
| 200 | OK | The request was received successfully. |
Failed Requests
The web service should return a response within 60 seconds. If the request times out without a response, the application should wait for 5 minutes then retry the request.
The web service returns a 4xx or 5xx HTTP response code when there are any errors and will include the following elements:
| Element | Description |
|---|---|
| error | The error message. |
Refer to the individual function documentation for function-specific error formats.
HTTP Error Codes
The table below provides additional details for commonly encountered error codes.
| Code | Message | Description |
|---|---|---|
| 400 | Bad Request | This response is returned if any of these conditions is true: * The specified URI is invalid. * The request is not formatted correctly. * The request is missing a required field. * The number of requests received exceed the request limit. * The request encountered a database deadlock. In this case, the developer should resend the request a short time later. |
| 401 | Unauthorized | The Authorization header is not included in the request. |
| 403 | Forbidden | This response is returned if any of these conditions is true: * The API Key is invalid or been revoked. |
| 404 | Not Found | The API Endpoint is invalid. |
| 409 | Conflict | A job for the specified definition is already queued or running. |
| 429 | Too Many Requests | This response is returned when services are overloaded either with too many requests from a single source or too many requests in aggregate. When this happens slow the rate of requests. This can also be caused by rate limiting. |
| 500 | Internal Server Error/Not Closed | This response is returned when the system is unable to process or The database malfunctioned. |
| 503 | Service Unavailable | This response is returned when the web service is down for maintenance. The partner application should sleep for 5 minutes then retry the request. If the request continues to fail after a few retries, the developer should contact admin@droplink.cc . |