エラー情報
リクエスト内容もしくはサーバでの処理中にエラーが発生した場合にはエラーレスポンスを返します。
エラーの種類は HTTP のレスポンスステータスコードで判別し、詳細はレスポンスボディの文字列で識別してください。
ステータスコードの 400 台はクライアントエラーで、500 台はサーバエラーとなります。
アプリケーションから返す基本的なエラー
リクエストパラメータの企業 ID 未許可の場合
HTTP レスポンスステータスコード: 400
{
"status": "error",
"message": [
"Company is not allowed."
]
}
アクセス時の企業IDとアクセスIPの組み合わせが未許可の場合
HTTP レスポンスステータスコード: 400
{
"status": "error",
"message": [
"Access IP is not allowed."
]
}
リクエストパラメータで必須項目の指定がない場合
HTTP レスポンスステータスコード: 400
{
"status": "error",
"message": [
"XXX / Missing data for required field."
]
}
リクエストパラメータで必須項目の値指定がない場合
HTTP レスポンスステータスコード: 400
{
"status": "error",
"message": [
"XXX / XXX is Empty."
]
}
リクエストパラメータで半角英数字以外を指定している場合
HTTP レスポンスステータスコード: 400
{
"status": "error",
"message": [
"XXX / XXX is half-width characters."
]
}
リクエストパラメータで測地系 指定誤りの場合
HTTP レスポンスステータスコード: 400
{
"status": "error",
"message": [
"datum / Datum is tokyo|wgs84."
]
}
リクエストパラメータで緯度経度フォーマット 指定誤りの場合
HTTP レスポンスステータスコード: 400
{
"status": "error",
"message": [
"lonlat_format / Lonlat_format is millsec|degree."
]
}
リクエストパラメータで車種 指定誤りの場合
HTTP レスポンスステータスコード: 400
{
"status": "error",
"message": [
"car_type / Car_type is invaild."
]
}
リクエストボディで指定フォーマットの場合
HTTP レスポンスステータスコード: 400
{
"status": "error",
"message": [
"Body is not Base64/Json/Gzip."
]
}
リクエストボディの走行データ不足場合
HTTP レスポンスステータスコード: 400
{
"status": "error",
"message": [
"Number of drive_data does not satisfy the analysis condition."
]
}
リクエストボディの走行データフォーマット 指定誤りの場合
HTTP レスポンスステータスコード: 400
{
"status": "error",
"message": [
"First date in drive_data is format error."
]
}
サービス元から返るエラー
インフラストラクチャにクラウドを採用しているため、
サービス元よりステータスコード、および、レスポンスボディの文字列が返る場合がございます。
主なエラーは以下のとおりです。
一定時間内に大量のリクエストを送信した場合(レートリミット)
HTTP レスポンスステータスコード: 429
{
"message": "Too Many Requests"
}
WAF(ウェブアプリケーションファイアウォール)によりアクセスが遮断された場合
HTTP レスポンスステータスコード: 403
{
"message": "Forbidden"
}