Traffic API 開発者ガイド（交通情報）

HTTP ステータスコード

Traffic API は、標準の HTTP ステータスコードをサポートしています。

表 1. HERE エラーコード
エラーコード	説明
200 OK です	成功を示しますが、リクエストで無効なリソース名または無効なパラメータの組み合わせが使用された場合にも返されます。
204 コンテンツがありません	リクエストが有効であったが、利用できるトラフィックデータがないことを示します。
400 リクエストが正しくありません	リクエストのパラメータ値が無効 `zoom` です ( 範囲外など ) 。例 : quadkey パラメータが無効です ([ 長さ ]22 文字、または [0,1,2,3] にない任意の文字 ) 。必須パラメータが指定されていません。このクエリでは、 bbox と quadkey の両方のパラメータが結合されますが、これは許可されていません。 bbox または quadkey パラメーターのいずれかを使用する必要があります。 bbox パラメーターの形式が無効です。 bbox パラメーターは、 [lat0] 、 [lon0];[lat1] 、 [lon1] の形式で指定する必要がありますフィルタリングパラメータの値が正しくありませんでした。
403 禁止です	リクエストに API キーがないか、正しくありません。 `token` 認証を使用している場合 `token` 、要求で使用しているが正しくありません。認証の詳細については、『 Identity & Access Management 開発者ガイド』を参照してください。
404 が見つかりません	リクエストでサポートされていないパラメータです。例 : URL のドメインセクションが有効なサービス環境を指していません。 URL のパスセクションが quadkey サービスインスタンスをポイントしていません。
500 内部エラー	サービスが利用できないか、サーバー設定に問題があります。
503 サービスを利用できません	システムの過負荷またはメンテナンスにより、サービスが一時的に利用できなくなっていることを示します

API は、すべての HERE API に共通の標準承認メカニズムをサポートしています。このメカニズムでは、以下に詳述するステータスコードを返すことができます。

表 2. 認証応答
シナリオ	応答コード	HTTP 応答メッセージ
`apiKey` が見つかりません	400	リクエストに `apiKey` パラメータがありません。注 : `app_id`/authentication を使用している場合`app_codeapp_idapp_code` は、およびのパラメータがありません。これらは両方ともクエリパラメーターとして渡す必要があります。使用可能な認証オプションについては、『 Identity & Access Management 開発者ガイド』を参照してください。
`apiKey` がリクエストに存在しますが、検証に失敗しました。	401	これは有効では `apiKey`ありません。注 : `app_id`/authentication を使用している場合`app_codeapp_idapp_code`は、との間で値がスワップされていないことを確認してください。使用可能な認証オプションについては、『 Identity & Access Management 開発者ガイド』を参照してください。
この要求された URL の認証メカニズム設定に一致するパターンがありません	404	URL リソースが見つかりません。
要求された URL が存在するが、その URL で HTTP verb がサポートされていない場合	405	この URL では、 HTTP メソッドはサポートされていません。
SSL が必要だが、要求が SSL 経由で送信されない場合。	400	この URL には SSL/TLS が必要です。 SSL/TLS を使用してリクエストを再試行してください。
予期しない認証エラーが発生しまし	500	サーバーエラー - 後でもう一度試してください。