最終更新日: 2026年01月07日
MonCargo API では、リクエストが失敗した場合にエラーコードを含むレスポンスを返します。このページでは、主要なエラーコードについて解説します。
エラーが発生した場合、以下の形式でレスポンスが返されます。
{
"statusCode": 400,
"code": "エラーコード",
"error": "Bad Request",
"message": "エラーメッセージ"
}
船社が指定されたトラッキング種別(Booking No. / B/L No. / Container No.)をサポートしていない場合に返されます。
リクエスト例:
curl -XPOST https://api.moncargo.io/v1/shipments \
-u api:YOUR_API_KEY \
-H 'Content-Type: application/json' \
-d '{
"shippingLine": "SITC",
"trackingType": "BOOKING_NUMBER",
"trackingNumber": "1234567890"
}'
レスポンス例:
{
"statusCode": 400,
"code": "UnsupportedTrackingType",
"error": "Bad Request",
"message": "該当のトラッキング種別はサポートされていません。"
}
| エラーコード | ステータスコード | 説明 |
|---|---|---|
UnsupportedTrackingType | 400 | 船社が該当のトラッキング種別に非対応 |
InvalidTrackingNumberFormat | 400 | トラッキング番号のフォーマットが不正 |
InvalidAnyNumberFormat | 400 | 番号が6文字以上24文字以下の半角英数字でない |
InvalidContainerNumberFormat | 400 | コンテナ番号の形式が不正(4文字のアルファベット + 7桁の数字) |
FST_ERR_VALIDATION | 400 | リクエストパラメータが不正 |
ShipmentAlreadyRegistered | 400 | 同じトラッキング番号の船荷が既に登録されている |
TrackingCountExceeded | 400 | 追跡数が契約プランの上限を超えている |
InvalidAccessToken | 401 | APIトークンが無効 |
AccessDenied | 401 | リソースへのアクセス権限がない |