# クラウドブラウザ オープン API

MoreLogin オープン API を使用して、MoreLogin クラウドブラウザ環境の起動、停止、接続、クエリを行います。

クラウドブラウザは、MoreLogin のブラウザプロファイルをリモートホスト上で実行します。環境を起動した後、CDP（Chrome DevTools プロトコル）で接続し、Puppeteer や Playwright などの自動化フレームワークから操作できます。

**Base URL**：`https://api.morelogin.com`

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


Version: 1.0.0

## Servers

```
https://api.morelogin.com
```

## Download OpenAPI description

[クラウドブラウザ オープン API](https://guide.morelogin.com/_bundle/@l10n/ja/API%20Reference/Cloud%20Browser/open-api.yaml)

## Cloud Browser

クラウドブラウザ環境の起動、停止、接続、クエリ

### クラウドブラウザを起動

 - [POST /cloudbrowser/start](https://guide.morelogin.com/ja/api-reference/cloud-browser/open-api/cloud-browser/startcloudbrowser.md): クラウドブラウザ環境を起動します。環境は STARTING 状態になり、リモートブラウザの準備が完了すると RUNNING に遷移します。

起動は非同期です。クラウドブラウザ環境をページ取得をポーリングして cloudBrowserStatus を確認し、環境が RUNNING になってからクラウドブラウザに接続を呼び出してください。

### クラウドブラウザを停止

 - [POST /cloudbrowser/stop](https://guide.morelogin.com/ja/api-reference/cloud-browser/open-api/cloud-browser/stopcloudbrowser.md): 実行中のクラウドブラウザ環境を停止します。force を true に設定すると、正常なシャットダウンを待たずに環境を強制的に解放します。

### クラウドブラウザ環境をページ取得

 - [POST /cloudbrowser/page](https://guide.morelogin.com/ja/api-reference/cloud-browser/open-api/cloud-browser/pagecloudbrowserenvironments.md): クラウドブラウザ環境をページ単位でクエリします。環境シーケンス番号、環境 ID、環境名、キーワード、グループでの絞り込みに対応しています。

### クラウドブラウザに接続

 - [POST /cloudbrowser/connect](https://guide.morelogin.com/ja/api-reference/cloud-browser/open-api/cloud-browser/connectcloudbrowser.md): 実行中のクラウドブラウザ環境の接続情報を返します。返された cdpUrl を使用して、Chrome DevTools プロトコル経由で自動化フレームワーク（Puppeteer、Playwright、Selenium）を接続できます。

環境は RUNNING 状態である必要があります。必要に応じて、まずクラウドブラウザを起動してください。