HTTP Status Codes
Traffic API supports the standard HTTP status codes.
Error code | Description |
---|---|
200 OK | Indicates success, but may also be returned when an invalid resource name and/or an invalid parameter combination has been used in the request. |
204 No Content | Indicates that the request was valid but there is no traffic data available. |
400 Bad request | Invalid parameter value in the request, for example zoom out of range. Examples include:
|
403 Forbidden | Incorrect token in the request. See Acquiring Credentials for more information. |
404 Not found | Unsupported parameter in the request. Examples include:
|
500 Internal error | The service is not available or server configuration issue. |
503 Service Unavailable | Indicates that the services is temporarily unavailable due to system overload or maintenance |
The API supports the standard authorization mechanism common to all HERE APIs. This mechanism can return status codes detailed below.
Scenario | Response Code | HTTP Response Message |
---|---|---|
app_id and app_code are both missing | 400 | The request is missing the app_id and app_code parameters. They must both be passed as query parameters. For information on how to obtain app_id and app_code , see Acquiring Credentials |
app_id is there but the app_code is missing | 400 | The request is missing the app_code . It must be passed as a query parameter. |
app_code is there but app_id is missing | 400 | The request is missing the app_id . It must be passed as a query parameter. |
app_id and app_code are both present in the request but the validation fails. | 401 | This is not a valid app_id and app_code pair. Please verify that the values are not swapped between the app_id and app_code . For more information, see Acquiring Credentials |
No matching pattern in the authentication mechanism configuration for this requested URL | 404 | The URL resource cannot be found. |
If the requested URL does exist but the HTTP verb is not supported for that URL | 405 | The HTTP method is not supported for this URL. |
If SSL is required, but the request is not sent over SSL. | 400 | SSL/TLS is required for this URL; please retry the request using SSL/TLS. |
Unexpected authentication error | 500 | Server error - please retry again at a later time. |