エラーコード

このページでは MoreLogin API が返す主なエラーコードを一覧します。

すべての API レスポンスは次の標準形式に従います：

{
  "code": 0,
  "msg": null,
  "data": {},
  "requestId": "unique-request-id"
}

エラーコードは単一の連番から割り当てられているのではありません。製品領域ごとに区間が割り当てられているため、先頭 2〜3 桁でどのサブシステムがリクエストを拒否したか分かります：

各操作には、返し得ることが分かっているコードが記載されています。エンドポイントのリトライと完了マトリクスからリンクされた製品別のページを参照してください。

リクエスト検証、権限チェック、ゲートウェイに由来し、業務ロジックからではないため、どの操作でも返り得ます。

インストールおよび電源操作では、さらに 33001–33033、33500–33520、33700–33724、33900–33910 の区間からデバイスサービス由来のコードが返ることがあります。どれが到達可能かは端末を提供するデバイスサービスに依存するため、各操作では個別に列挙していません。

/cloudbrowser/start、/cloudbrowser/stop、/cloudbrowser/connect が返します。起動リクエストがディスパッチされた後に発生するコードは起動レスポンスではなく /cloudbrowser/page に現れます。

Webhook 設定エンドポイントがコールバック URL を拒否したときに返されます。

現行のアプリケーションゲートウェイは自身のレート制限拒否を業務コード 35000 で表し、HTTP 429 を明示的には設定しません。エッジプロキシや将来のゲートウェイでは 429 が返る可能性もあるため、クライアントは両方の形式を扱ってください。

この公開 API には現時点で汎用の冪等キーヘッダーはありません。したがって状態を変えるリクエストでは、エンドポイントごとの状態照会が安全な復旧手順の一部になります。

非同期処理では code: 0 のレスポンスが「完了」ではなく「受理」を意味することがあります。各操作のドキュメントに記載されたステータス項目と終了状態に従ってください。

全操作についてはエンドポイントのリトライと完了マトリクス、ポーリングの流れと終了状態については非同期操作を参照してください。

ヒント：サポートへ問い合わせる際は、レスポンスの requestId を必ず添えてください。調査が早くなります。