# ローカル API

MoreLogin APIは、ブラウザプロファイル、クラウドフォン、および関連リソースをプログラムで管理できる、包括的で開発者フレンドリーなRESTfulインターフェースを提供します。MoreLoginローカルAPIはお使いのマシン上で動作し、127.0.0.1:40000でアクセスできます

Version: 2026-09-05

## Servers

Local API
```
http://127.0.0.1:40000
```

## Download OpenAPI description

 - [ローカル API](https://guide.morelogin.com/_bundle/@l10n/ja/API%20Reference/Browser/local-api.yaml)

## Profiles

 - [POST /api/env/create/quick](https://guide.morelogin.com/ja/api-reference/browser/local-api/profiles/createbrowserprofilequicklocal.md): 同一の設定を共有するブラウザープロファイルを 1〜200 件作成します。 - **前提条件**：チームプランに十分な残プロファイル数があり、当日の作成上限を使い切っていないこと。`isEncrypt=1` にはチームで暗号鍵が設定されている必要があります。Firefox は Windows と macOS でのみ利用できます。`groupId` は既に存在していなければなりませんが、代わりに `g
 - [POST /api/env/create/advanced](https://guide.morelogin.com/ja/api-reference/browser/local-api/profiles/createbrowserprofileadvancedlocal.md): 完全な指紋設定を持つブラウザープロファイルを 1 件作成します。 - **前提条件**：クイック作成と同じプランおよび当日上限のチェックが行われます。プロファイル名はチーム内で一意であること、座標は中国本土の外であること、`advancedSetting.ua` は `uaVersion` と整合していることが必要です。`proxyId` を指定する場合、それがチーム内に既に存在していなければなり
 - [POST /api/env/update](https://guide.morelogin.com/ja/api-reference/browser/local-api/profiles/updatebrowserprofilelocal.md): 既存のブラウザープロファイルを更新します。リクエストに含まれるフィールドのみが変更されます。 - **前提条件**：プロファイルがチーム内に存在すること。エンドツーエンド暗号化されたプロファイルは更新できません。OS とブラウザー種別は変更できません。起動中のプロファイルも更新できます。 - **副作用**：プロファイルのレコード、その拡張設定、Cookie を書き込み、高度な指紋設定をマージしま
 - [POST /api/env/removeToRecycleBin/batch](https://guide.morelogin.com/ja/api-reference/browser/local-api/profiles/batchdeletebrowserprofilesusingpost.md): 1 件以上のブラウザープロファイルをゴミ箱へ移動します。 - **前提条件**：プロファイルが既にゴミ箱にないこと、起動中でないこと、移管中でないこと。先にブラウザーを閉じてください。 - **副作用**：論理削除です。レコード、指紋、クラウドキャッシュは保持され、プロファイルはタイムスタンプ付きでゴミ箱行きとしてマークされます。プランの容量は即座に解放されますが、当日作成カウンターは戻りません。
 - [POST /api/env/page](https://guide.morelogin.com/ja/api-reference/browser/local-api/profiles/listbrowserprofilesusingpost.md): 認証済みメンバーから見えるブラウザープロファイルをページ単位で一覧します。 - **副作用**：なし。読み取り専用。バックオフを入れれば安全にリトライできます。 - **フィルタリング**：`keyword` はプロファイル名、備考、タグ名、グループ名に一致します。`groupId` が `0` の場合は未グループを意味します。 - **補足**：一般メンバー、およびプラットフォームプロキシとダイ
 - [POST /api/env/detail](https://guide.morelogin.com/ja/api-reference/browser/local-api/profiles/getbrowserprofiledetailsusingpost.md): 単一のブラウザープロファイルの完全な設定を、高度な指紋設定と Cookie を含めて返します。 - **前提条件**：プロファイルがチーム内に存在し、呼び出し元がそれに対する権限を持つこと。 - **副作用**：なし。読み取り専用。バックオフを入れれば安全にリトライできます。 - **補足**：アカウントのパスワードと 2 要素認証のシークレットは、チームオーナーに対してのみ、またはプロファイルが
 - [POST /api/env/lock/query](https://guide.morelogin.com/ja/api-reference/browser/local-api/profiles/querybrowserlockstatususingpost.md): ブラウザープロファイルが現在、他のチームメンバーに占有されているかを報告します。 - **副作用**：なし。読み取り専用。バックオフを入れれば安全にリトライできます。 - **意味**：`true` になるには次のすべてが必要です — チームでセキュリティロック機能が有効、ロックが存在する、保持者が呼び出し元以外である。ロックはメンバー単位で有効期限付きに保持されるため、自然に失効することがありま
 - [POST /api/env/setGroup/batch](https://guide.morelogin.com/ja/api-reference/browser/local-api/profiles/setbrowsergroupsbatchlocal.md): グループ名を指定してブラウザープロファイルをグループへ移動します。 - **前提条件**：`envIds` または `uniqueIds` の少なくとも一方を指定します。`groupName` は必須で、50 文字以内です。このエンドポイントでプロファイルのグループを外すことはできません。 - **副作用**：名前が存在しない場合、グループが自動作成されます。これは**チームの 1000 グループ
 - [POST /api/env/setProxy/batch](https://guide.morelogin.com/ja/api-reference/browser/local-api/profiles/setbrowserproxiesbatchlocal.md): 複数のブラウザープロファイルにプロキシを紐付けます。 - **前提条件**：`envIds` または `uniqueIds` の少なくとも一方を指定します。`proxyId` を指定する場合、それがチーム内に既に存在していなければならず、存在しなければ自動作成されるのではなく呼び出しが拒否されます。 - **副作用**：各プロファイルに `proxyId` を書き込みます。`proxyId` を省
 - [POST /api/env/setRemark/batch](https://guide.morelogin.com/ja/api-reference/browser/local-api/profiles/setbrowserremarksbatchlocal.md): 複数のブラウザープロファイルの備考を設定します。空文字列を渡すと消去されます。 - **前提条件**：`envIds` または `uniqueIds` の少なくとも一方を指定します。呼び出し元は各プロファイルに対する権限を持つ必要があります。 - **副作用**：備考フィールドのみを書き込みます。 - **完了シグナル**：同期的です。同一のリクエストボディに対して完全に冪等です。
## Runtime

 - [POST /api/env/start](https://guide.morelogin.com/ja/api-reference/browser/local-api/runtime/startbrowserprofileusingpost.md): プロファイルの起動に使用します。プロファイルIDを指定する必要があります。起動が成功すると、プロファイルのデバッグインターフェースを取得して、SeleniumおよびPuppeteerによる自動化を実行できます。Seleniumを使用する場合は、対応するカーネルバージョンに一致するWebDriverを使用してください。WebDriverのパスは、プロファイル起動後のレスポンスから取得できます。Mor
 - [POST /api/env/close](https://guide.morelogin.com/ja/api-reference/browser/local-api/runtime/closebrowserprofilelocal.md): 実行中のブラウザープロファイルを閉じます。 - **実行場所**：MoreLogin デスクトップクライアントがすべてお使いのマシン上で処理します。**サーバー側の実装はありません**。したがってクライアントがそのプロファイルを開いていること以外にアカウント・チーム・状態の前提条件はなく、クラウドには何も記録されません。 - **副作用**：ローカルのブラウザープロセスとウィンドウに限られます。プ
 - [POST /api/env/status](https://guide.morelogin.com/ja/api-reference/browser/local-api/runtime/getbrowserprofilestatuslocal.md): 1 件以上のブラウザープロファイルの現在の稼働状態を返します。 - **副作用**：なし。読み取り専用。バックオフを入れれば安全にリトライできます。 - **値**：各プロファイルは `running` または `stopped` のいずれかを報告します。これが起動および終了操作の完了シグナルです。 - **補足**：解決できない ID は黙って破棄されます。すべてが解決できない場合にのみ呼び出し
 - [POST /api/env/closeAll](https://guide.morelogin.com/ja/api-reference/browser/local-api/runtime/closeallbrowserprofileslocal.md): このクライアントで実行中のすべてのブラウザープロファイルを閉じます。 - **実行場所**：MoreLogin デスクトップクライアントがすべてお使いのマシン上で処理します。**サーバー側の実装はありません**。したがってクライアントがそのプロファイルを開いていること以外にアカウント・チーム・状態の前提条件はなく、クラウドには何も記録されません。 - **副作用**：ローカルのブラウザープロセスと
 - [POST /api/env/getAllProcessIds](https://guide.morelogin.com/ja/api-reference/browser/local-api/runtime/getallbrowserprocessidslocal.md): 実行中のブラウザープロファイルのプロセス ID を一覧します。 - **実行場所**：MoreLogin デスクトップクライアントがすべてお使いのマシン上で処理します。**サーバー側の実装はありません**。したがってクライアントがそのプロファイルを開いていること以外にアカウント・チーム・状態の前提条件はなく、クラウドには何も記録されません。 - **副作用**：ローカルのブラウザープロセスとウィン
 - [POST /api/env/getAllDebugInfo](https://guide.morelogin.com/ja/api-reference/browser/local-api/runtime/getallbrowserdebuginfolocal.md): 実行中のブラウザープロファイルのデバッグ用エンドポイントを一覧します。 - **実行場所**：MoreLogin デスクトップクライアントがすべてお使いのマシン上で処理します。**サーバー側の実装はありません**。したがってクライアントがそのプロファイルを開いていること以外にアカウント・チーム・状態の前提条件はなく、クラウドには何も記録されません。 - **副作用**：ローカルのブラウザープロセス
 - [POST /api/env/core/download](https://guide.morelogin.com/ja/api-reference/browser/local-api/runtime/downloadbrowserkernelslocal.md): ブラウザカーネルをダウンロードしてインストールします。1リクエストあたり最大20個のカーネルのバッチダウンロードをサポートします。この操作のタイムアウトは最大約30分です。呼び出し側のタイムアウトは1805秒以上に設定してください。 MoreLoginクライアントバージョン **2.61.1** 以上が必要です。 ### 重複リクエストの処理 - 同一リクエスト内で同じブラウザタイプとメジャーバー
## Cloud Runtime

 - [POST /api/cloudbrowser/start](https://guide.morelogin.com/ja/api-reference/browser/local-api/cloud-runtime/startcloudruntimelocal.md): ブラウザープロファイルをクラウドランタイムとして起動します。 - **前提条件**：プロファイルが自チームに存在し、エンドツーエンド暗号化されておらず、移管中でもないこと。**プロキシが必須**で、起動が受理される前にその到達性が検査されます。ブラウザーカーネルはクラウドブラウザーが対応するものでなければならず、これにより Firefox は除外されます。チームの同時オープン上限が適用され、クラウ
 - [POST /api/cloudbrowser/stop](https://guide.morelogin.com/ja/api-reference/browser/local-api/cloud-runtime/stopcloudruntimelocal.md): プロファイルが動作しているクラウドランタイムを停止します。 - **前提条件**：そのプロファイルについて、自分が開始した実行が存在する必要があります。ランタイムが既に停止済みまたは解放中の状態で呼び出した場合は、何もせず成功します。 - **副作用**：課金を止め、使用量を確定し、プロファイルロックを解放し、ランタイム解放前にプロファイルと Cookie をクラウドへアーカイブするようクライアン
 - [POST /api/cloudbrowser/page](https://guide.morelogin.com/ja/api-reference/browser/local-api/cloud-runtime/pagecloudruntimeslocal.md): 呼び出しメンバーから見えるブラウザープロファイルを、クラウドランタイムの状態と併せて一覧します。 - **副作用**：なし。読み取り専用。バックオフを入れれば安全にリトライできます。 - **ステータス値**：`cloudBrowserStatus` は `STARTING`、`RUNNING`、`CLOSED` のいずれかのみです。**`RUNNING` はブラウザーが使用可能であることを意味し
 - [POST /api/cloudbrowser/connect](https://guide.morelogin.com/ja/api-reference/browser/local-api/cloud-runtime/connectcloudruntimelocal.md): 起動中のクラウドランタイムへの接続情報を返します。 - **前提条件**：ランタイムがちょうど `RUNNING` 状態で、かつ自分が起動したものである必要があります。停止中またはアーカイブ中のランタイムは、`/cloudbrowser/page` がまだ `RUNNING` と報告していても拒否されます。 - **副作用**：新しいデスクトップアクセストークンを発行し、接続メンバーとして自分を記
## Fingerprint & Device Config

 - [GET /api/env/advanced/ua/versions](https://guide.morelogin.com/ja/api-reference/browser/local-api/fingerprint-and-device-config/listadvanceduaversionslocal.md): 公開済みのブラウザーカーネルとユーザーエージェントのメジャーバージョンを返します。 - **副作用**：なし。読み取り専用。バックオフを入れれば安全にリトライできます。 - **返却内容**：Open API 面は公開済みカーネルのみを返し、Local API 面は稼働中のクライアントバージョンで絞り込むため、2 つの面で異なる集合が返ることがあります。新しいカーネルが公開されるとリストは変化しま
 - [POST /api/env/advanced/ua/get](https://guide.morelogin.com/ja/api-reference/browser/local-api/fingerprint-and-device-config/getbrowserprofileuausingpost.md): 指定した OS とブラウザーブランドに合致するユーザーエージェントを生成します。 - **前提条件**：Firefox は Windows または macOS のみで有効です。`osVersion` は対応リリースのいずれかである必要があります。 - **副作用**：ありませんが、**結果は決定的ではありません** — 同じリクエストでも毎回異なるユーザーエージェントが返ります。キャッシュキーには
 - [POST /api/env/base/resolution/list](https://guide.morelogin.com/ja/api-reference/browser/local-api/fingerprint-and-device-config/listresolutionsusingpost.md): ユーザーエージェントまたは OS に対して利用できる画面解像度を返します。 - **副作用**：なし。読み取り専用。バックオフを入れれば安全にリトライできます。 - **返却内容**：指紋ベースデータサービスから配信されるため、そのデータの更新に応じてリストが変化します。
 - [GET /api/system/platform/list](https://guide.morelogin.com/ja/api-reference/browser/local-api/fingerprint-and-device-config/listsystemplatformslocal.md): ブラウザープロファイルに紐付けできるプラットフォームとサイトを返します。 - **副作用**：なし。読み取り専用。バックオフを入れれば安全にリトライできます。 - **返却内容**：表示対象としてマークされたシステムプラットフォームとサイト、および呼び出し元チーム独自のカスタムサイト URL です。したがってこの一覧は、MoreLogin が新しいプラットフォームを公開したときにも、自チームが高度
 - [POST /api/env/base/list](https://guide.morelogin.com/ja/api-reference/browser/local-api/fingerprint-and-device-config/listtimezoneandlanguageusingpost.md): ブラウザープロファイルで利用できるタイムゾーンと言語を返します。 - **副作用**：なし。読み取り専用。バックオフを入れれば安全にリトライできます。 - **補足**：現時点でレスポンスはリクエストボディに依存しません — サービスは指定された OS や言語を下流へ渡さないため、入力にかかわらず同じリストが返ります。
 - [POST /api/env/fingerprint/refresh](https://guide.morelogin.com/ja/api-reference/browser/local-api/fingerprint-and-device-config/refreshfingerprintusingpost.md): ブラウザープロファイルの指紋を再生成します。 - **前提条件**：`envId` または `uniqueId` でプロファイルを指定します。暗号化されたプロファイルは拒否されます。起動中のプロファイルもブロックされませんが、新しい指紋は次回起動時から適用されます。 - **副作用**：新しい指紋を生成し、ホスト名と MAC アドレスをランダム化し、ブラウザーカーネルを再マッチングします。リクエス
 - [POST /api/env/base/mobile/devices](https://guide.morelogin.com/ja/api-reference/browser/local-api/fingerprint-and-device-config/listmobiledevicemodelslocal.md): Android と iOS のブラウザープロファイルで利用できるモバイル端末の機種を返します。 - **副作用**：なし。読み取り専用。バックオフを入れれば安全にリトライできます。 - **返却内容**：MoreLogin の端末テーブルと指紋ベースデータサービスの積集合です。どちらか一方にしか存在しない機種は除外され、返される `id` は端末テーブルではなく指紋サービスのものです。
## Cache & Window

 - [POST /api/env/removeLocalCache](https://guide.morelogin.com/ja/api-reference/browser/local-api/cache-and-window/clearlocalprofilecacheusingpost.md): ローカルの MoreLogin クライアントに、ブラウザープロファイルのキャッシュデータ消去を依頼します。 - **前提条件**：`envId` または `uniqueId` でプロファイルを指定し、キャッシュ種別を少なくとも 1 つ選びます。Firefox のプロファイルではすべての種別を一度に選ぶ必要があります。 - **副作用**：サービスはリクエストを検証して記録するだけで、**実際の削除
 - [POST /api/env/cache/cleanCloud](https://guide.morelogin.com/ja/api-reference/browser/local-api/cache-and-window/cleancloudcachelocal.md): ブラウザープロファイルのクラウド側キャッシュを消去します。 - **前提条件**：`envId` または `uniqueId` でプロファイルを指定し、キャッシュ種別を少なくとも 1 つ選び、プロファイルが移管中でないこと。ローカルクライアントのキャッシュは変更されません。 - **副作用**：一般種別を消去すると、クラウド上の LocalStorage、IndexedDB、拡張機能データが削除さ
 - [POST /api/env/getAllScreen](https://guide.morelogin.com/ja/api-reference/browser/local-api/cache-and-window/getallbrowserscreenslocal.md): クライアントがウィンドウを配置できるディスプレイを一覧します。 - **実行場所**：MoreLogin デスクトップクライアントがすべてお使いのマシン上で処理します。**サーバー側の実装はありません**。したがってクライアントがそのプロファイルを開いていること以外にアカウント・チーム・状態の前提条件はなく、クラウドには何も記録されません。 - **副作用**：ローカルのブラウザープロセスとウィン
 - [POST /api/env/arrangeWindows](https://guide.morelogin.com/ja/api-reference/browser/local-api/cache-and-window/arrangebrowserwindowslocal.md): 実行中のブラウザープロファイルのウィンドウを画面上に整列します。 - **実行場所**：MoreLogin デスクトップクライアントがすべてお使いのマシン上で処理します。**サーバー側の実装はありません**。したがってクライアントがそのプロファイルを開いていること以外にアカウント・チーム・状態の前提条件はなく、クラウドには何も記録されません。 - **副作用**：ローカルのブラウザープロセスとウィ