このトピックでは、モバイルゲートウェイサービスを使用する際に表示される結果コードについて説明します。
ゲートウェイ側の結果コード
1000 は API 呼び出しが成功したことを示し、それ以外のコードは失敗を示します。
1001-5999 および 7XXX はゲートウェイエラーを示します。
7XXX は、署名検証または復号中にセキュリティガードがエラーを報告したことを示します。詳細については、「セキュリティガードの結果コード」をご参照ください。
結果コードに加えて、レスポンスヘッダーの
Memoフィールドとtipsフィールドで詳細なエラー情報を確認できます。パブリッククラウドユーザーは、ゲートウェイサーバー上の
~/logs/gateway/gateway-error.logログからも詳細なエラー情報を確認できます。
例外が発生した場合は、ゲートウェイ例外のトラブルシューティングを使用してエラーのトラブルシューティングを試みることができます。詳細については、「ゲートウェイ例外のトラブルシューティング」をご参照ください。
レスポンスコード | 説明 | 解説 |
1000 | 処理成功 | ゲートウェイ API 呼び出しが正常に処理されました。 |
1001 | アクセスが拒否されました。 | Mock 形式が間違っているか、 |
1002 | 呼び出し数が制限を超えています。 | トラフィック制限構成 を有効にした後、トラフィック制限がトリガーされると、この例外が発生します。 |
1005 | 権限がありません | API 認証 を有効にした後、API を呼び出すときに認証検証に失敗します。 |
2000 | ログインセッションがタイムアウトしました。 | 認証検証機能が有効になっている場合、ログイン状態が有効になっていないと、この例外がトリガーされます。 |
3000 | RPC インターフェイスが存在しないか、停止しています | 現在の workspaceId に対応する環境では、appId に対応するモバイル アプリケーションに operationType で構成された API サービスがないか、API サービスが 開く 状態ではありません。 |
3001 | リクエストデータが空です。 | クライアントリクエストデータの |
3002 | データ形式が正しくありません | RPC リクエスト形式に問題があります。パブリッククラウドユーザーは、サーバーログ |
3003 | データの復号に失敗しました | データの復号に失敗しました。 |
4001 | サービスリクエストタイムアウト | MGS が業務システムサービスの呼び出しをタイムアウトしました。バックエンド業務システムが過負荷になっている場合は、バックエンドシステムの実行状態を確認する必要があります。タイムアウト設定が不適切な場合は、適切に調整できます。注: デフォルトのタイムアウト期間は 3 秒です。 |
4002 | リモート呼び出しサービスシステム例外 | MGS が業務システムサービスを呼び出したときに例外が発生しました。パブリッククラウドユーザーは、サーバーログ |
4003 | API グループ HOST 例外 | MGS が HTTP 業務システムサービスを呼び出したときに、 |
5000 | 不明なエラーが発生しました。 | その他の重大なエラー。パブリッククラウドユーザーは、サーバーログ |
7000 | 公開鍵が設定されていません | モバイルアプリのセキュリティガードに appId に対応するキーがないか、ゲートウェイが appId に対応する署名キーを取得できません。 |
7001 | 署名検証のパラメーターが不足しています | ゲートウェイサーバーが署名を検証できませんでした。 |
7002 | 署名検証に失敗しました | ゲートウェイサーバーが署名を検証できませんでした。 |
7003 | 署名検証 - タイムリー性に失敗しました | API リクエスト入力パラメーターの ts タイムスタンプが、システムによって設定された時間有効性を超えています。クライアント時間がシステム時間かどうかを確認する必要があります。 |
7007 | 署名を確認 - ts パラメーターがありません | API リクエストに署名検証 ts パラメーターがありません。 |
7014 | 署名検証 - sign パラメーターがありません | API リクエストに sign パラメーターがありません。ほとんどの場合、クライアントがデータに署名できませんでした。その結果、sign パラメーターがありません。クライアントのセキュリティガード画像が正しいことを確認してください。 |
8002 | クロスドメイン事前チェックリクエスト (CORS プリフライト) | クロスドメイン事前チェックリクエスト。 |
ビジネス側の結果コード
次の結果コードを使用すると、業務システムサーバー内のエラーメッセージを表示できます。
各業務システムの ~/logs/mobileservice/monitor.log ログを表示して、例外の詳細を確認できます。
レスポンスコード | 該当する契約 | 説明 | 解説 |
6000 | MPC、DUBBO | RPC - ターゲットサービスが見つかりません | 公開されたサービスが見つからないか、サーバーにアクセスできないか、サービスが移行されています。 |
6001 | MPC、DUBBO | RPC - ターゲットメソッドが見つかりません | 公開されたサービスのメソッドが見つかりません。 |
6002 | MPC、DUBBO | RPC - パラメーター数が正しくありません | 入力パラメーターの数が、宣言されたパラメーターの数と等しくありません。 |
6003 | MPC、DUBBO | RPC - ターゲットメソッドにアクセスできません | ターゲットメソッドを呼び出すことができません。 |
6004 | HTTP、MPC、および DUBBO | RPC - JSON 解析例外 | HTTP: RPC パラメーターをバックエンド HTTP リクエストパラメーターに変換中に例外が発生しました。 MPC/DUBBO: RPC JSON 形式のデータをビジネスパラメーターオブジェクトに逆シリアル化できませんでした。 |
6005 | MPC、DUBBO | RPC - ターゲットメソッドを呼び出すときのパラメーターが無効です | リフレクション操作を呼び出すときのパラメーターが無効です。 |
6007 | MPC、DUBBO | RPC - 認証ログインサービスが利用できません | 認証ログインポートが SPI パッケージに実装されていないか、認証ログインポートの構成が正しくありません。 |
6666 | HTTP、MPC、および DUBBO | RPC - ビジネスが例外をスローします | HTTP: バックエンドシステムから返された HTTP ステータスコードが 200 と等しくありません。 MPC/DUBBO: ビジネス側でスローされた例外。 RPC は処理できず、ビジネス例外として統一されます。 |
Android クライアント結果コード
レスポンスコード | 説明 | プロンプトコピー |
0 | 不明なエラー。 | 不明なエラーです。後でもう一度お試しください。 |
1 | クライアントが通信オブジェクトを見つけられません。トランスポートが設定されていません | ネットワークエラーが発生しました。後でもう一度お試しください。 |
2 | クライアントにネットワークがありません。たとえば、ユーザーがネットワークを無効にしているか、アプリケーションのネットワーク権限を無効にしている場合などです。 | ネットワークに接続できません |
3 | SSL ハンドシェイクエラー、SSL 証明書エラーなどの SSL 関連のエラー | クライアント証明書が正しくありません。モバイル端末の時間設定が正確かどうかを確認してください。 |
4 | クライアント ネットワーク接続タイムアウト、TCP 接続タイムアウト。現在のタイムアウト期間は 10 秒です。 | ネットワークの不良 |
5 | クライアントのネットワーク速度が遅すぎる、データの読み取りおよび書き込みがタイムアウトする、socketTimeout などのシナリオ | ネットワークの不良 |
6 | クライアントがサーバーからの応答を要求しない場合、NoHttpResponseException | ネットワークエラーが発生しました。後でもう一度お試しください。 |
7 | クライアントネットワーク IO エラー。 IOException に対応 | ネットワークエラーが発生しました。後でもう一度お試しください。 |
8 | クライアント ネットワーク リクエストのスケジューリング エラー、実行スレッドの割り込み例外 | ネットワーク エラーが発生しました。後でもう一度お試しください。 |
9 | シリアル化エラー、注釈処理エラー、スレッド実行エラーなどのクライアント処理エラー | ネットワークエラーが発生しました。後でもう一度お試しください。 |
10 | クライアントデータの逆シリアル化エラー、サーバーデータ形式エラー | ネットワークエラーが発生しました。後でもう一度お試しください。 |
13 | スレッドが中断されたときにネットワーク リクエストが中断されるなど、リクエスト中断エラー | ネットワーク エラーが発生しました。後でもう一度お試しください。 |
レスポンスコード | 説明 | プロンプトコピー |
0 | 不明なエラー。 | 不明なエラーです。後でもう一度お試しください。 |
1 | クライアントが通信オブジェクトを見つけられません。トランスポートが設定されていません | ネットワークエラーが発生しました。後でもう一度お試しください。 |
2 | クライアントにネットワークがありません。たとえば、ユーザーがネットワークを無効にしたか、アプリケーションのネットワーク権限を無効にしています | ネットワークに接続できません |
3 | SSL 関連のエラー。SSL ハンドシェイクエラーと SSL 証明書エラーを含みます | クライアント証明書が正しくありません。携帯電話の時間設定が正確かどうかを確認してください。 |
iOS RPC リクエストがエラーコードを返します
値 | ステータスコード | 意味 |
0 | kDTRpcNetworkError | ネットワークに接続できません。 重要 すべてのネットワーク障害はここに分類され、具体的な障害エラーは userinfo を介して送信されます。 userinfo ディクショナリ内の対応するエラーのキー値は kDTRpcErrorCauseError です。 |
1 | kDTRpcEmptyResponse | サーバーから返されたデータが空です。 |
2 | kDTRpcInvalidJSONString | サーバーから返された JSON 文字列の形式が正しくないため、JSON オブジェクトに正常に変換できません。 |
3 | kDTRpcDecodeObjectError | JSON オブジェクトのデシリアライズ エラーです。 |
4 | kDTRpcNetworkCancelled | ネットワークがキャンセルされました。 |
5 | kDTRpcEncodeObjectError | JSON オブジェクトのシリアライズ エラーです。 |
6 | kDTRpcProtocolBuffersDecodeError | PB オブジェクトのデシリアライズ エラーです。 |
9 | KDTRpcSizeControlError | RPC が大きすぎる場合、例外が直接スローされます(このエラーは呼び出し元に委任されます)。 |
24 | KDTRpcAbandonError | アカウントを切り替えるときに、ログイン RPC の後に返された RPC が破棄され、例外が直接スローされます。 |
3003 | / | 復号のエラーです。 |