# エラーコード

このページには、MoreLogin API によって返される一般的なエラー コードがリストされています。

## 応答フォーマット

すべての API 応答は次の標準形式に従います。

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

| フィールド | タイプ | 説明 |
|  --- | --- | --- |
| `code` | 整数 | `0` = 成功、`>0` = エラー |
| `msg` | 文字列 | エラーメッセージ(成功時はnull) |
| `data` | オブジェクト | 応答データ |
| `requestId` | 文字列 | トラブルシューティング用の一意のリクエスト識別子 |


## 一般的なエラーコード

### 一般的なエラー

| コード | 説明 | 解決策 |
|  --- | --- | --- |
| `0` | 成功 | — |
| `99001` | 無効なパラメータ | リクエスト本文の形式と必須フィールドを確認してください |
| `99002` | 許可が拒否されました | アカウントの権限を確認してください |
| `99003` | リクエスト例外 | 回答に基づいて必要な業務調整を行ってください |
| `99004` | リクエスト本文が大きすぎます | リクエスト本文を確認してください |
| `429` | レート制限を超えました | リクエストの頻度を減らし、遅延後に再試行します |


### ブラウザ プロファイル エラー (ローカル API)

| コード | 説明 | 解決策 |
|  --- | --- | --- |
| `100` | プロファイルはすでに実行されています | 最初に `/api/env/close` を使用してプロファイルを閉じます |
| `101` | プロファイルが見つかりません | `envId` または `uniqueId` を確認してください |
| `102` | MoreLogin クライアントが実行されていない | MoreLogin デスクトップ アプリケーションを起動します。 |
| `103` | 暗号化キーが必要です | 暗号化されたプロファイルには `encryptKey` を指定してください |


### クラウド電話エラー (オープン API)

| コード | 説明 | 解決策 |
|  --- | --- | --- |
| `200` | クラウドフォンはオフラインです | まずクラウドフォンの電源を入れます |
| `201` | アプリのインストールに失敗しました | `appVersionId` または `packageName` を確認してください |
| `202` | ファイルのアップロードに失敗しました | ファイルの URL と宛先パスを確認する |


## HTTPステータスコード

| ステータス | 説明 |
|  --- | --- |
| `200` | リクエストは処理されました (ビジネス結果については `code` フィールドを確認してください) |
| `401` | 未承認 - 無効または期限切れのアクセス トークン |
| `403` | 禁止 — 権限が不十分です |
| `429` | リクエストが多すぎます - レート制限を超えました |
| `500` | 内部サーバー エラー — サポートにお問い合わせください |


> **ヒント**: トラブルシューティングを迅速に行うため、サポートに連絡する場合は、必ず応答の `requestId` を含めてください。