# Open API

MoreLogin Open API から MoreLogin のブラウザープロファイルとクラウドランタイムをリモート管理します。

**ベース URL**：`https://api.morelogin.com`

Open API は Local API と同じブラウザープロファイルを管理しますが、MoreLogin デスクトップクライアントを必要としません。ローカルクライアントが介在しないため、Open API は自分のマシン上でブラウザーを起動できません。代わりに、MoreLogin のインフラ上で動作し Chrome DevTools Protocol（CDP）で操作する**クラウドランタイム**としてプロファイルを起動できます。

| 機能 | Local API | Open API |
| --- | --- | --- |
| プロファイル、プロキシ、グループ、タグの管理 | 可 | 可 |
| 自分のマシンでブラウザーを起動 | 可 | 不可 |
| MoreLogin クラウドでブラウザーを起動 | 可 | 可 |

**ID のエンコード**：MoreLogin の ID はサーバー上では 64 ビット整数ですが、JavaScript での精度欠落を避けるため JSON では十進文字列としてシリアライズされます。文字列として送信し、文字列として読み取ってください。

認証は OAuth2 ベアラートークンを使用します。詳細は[認証](../Getting%20Started/authentication.md)を参照してください。


Version: 2026-09-05

## Servers

[object Object]
```
https://api.morelogin.com
```

## Security

### OpenApiBearer

[object Object]

Type: http
Scheme: bearer
Bearer Format: JWT

## Download OpenAPI description

 - [Open API](https://guide.morelogin.com/_bundle/@l10n/ja/API%20Reference/Browser/open-api.yaml)

## Profiles

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

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

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

 - [POST /env/cache/cleanCloud](https://guide.morelogin.com/ja/api-reference/browser/open-api/cache/cleancloudcacheopenapi.md): ブラウザープロファイルのクラウド側キャッシュを消去します。 - **前提条件**：`envId` または `uniqueId` でプロファイルを指定し、キャッシュ種別を少なくとも 1 つ選び、プロファイルが移管中でないこと。ローカルクライアントのキャッシュは変更されません。 - **副作用**：一般種別を消去すると、クラウド上の LocalStorage、IndexedDB、拡張機能データが削除さ