# クイックスタート

5 分で MoreLogin API を起動して実行できます。

## ブラウザ自動化 (ローカル API)

**シナリオ:** ブラウザー プロファイルを作成して起動し、Puppeteer 経由で接続してスクリプトを実行し、停止します。

### 前提条件

- MoreLogin デスクトップ アプリ **v2.15.0+** がローカルにインストールされ、実行されています。
- Puppeteer がインストールされました (`npm i puppeteer-core`)。


### ステップ 1: ブラウザプロファイルを作成する

```bash
curl -X POST "http://127.0.0.1:40000/api/env/create/quick" \
  -H "Content-Type: application/json" \
  -d '{
    "browserTypeId": 1,
    "operatorSystemId": 1,
    "quantity": 1
  }'
```

*このエンドポイントは `data` を作成したプロファイル ID の配列として返します。以降のステップでは `data[0]` を `envId` として使用してください (例: `1993244721490239488`)。リソース ID は 10 進文字列です。*

### ステップ 2: プロファイルを開始してデバッグ ポートを取得する

```bash
curl -X POST "http://127.0.0.1:40000/api/env/start" \
  -H "Content-Type: application/json" \
  -d '{"envId": "1993244721490239488"}'
```

*応答には `debugPort` (例: `12345`) が含まれます。*

### ステップ 3: Puppeteer を接続する (Node.js)

```javascript
const puppeteer = require('puppeteer-core');

(async () => {
  const browser = await puppeteer.connect({
    browserURL: 'http://127.0.0.1:12345'
  });
  const page = await browser.newPage();
  await page.goto('https://www.morelogin.com');
  console.log(await page.title());
  await browser.disconnect();
})();
```

### ステップ 4: プロファイルを停止する

```bash
curl -X POST "http://127.0.0.1:40000/api/env/close" \
  -H "Content-Type: application/json" \
  -d '{"envId": "1993244721490239488"}'
```

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

**シナリオ:** クラウド電話を簡単に作成し、起動し、アプリケーションをインストールし、RPA スケジュールをトリガーします。

### 前提条件

- MoreLogin ダッシュボードの API ID と API キー。
- ステップ 1–3 は新規アカウントでも実行できます。ステップ 4 にはチームのアプリライブラリに少なくとも 1 つのアプリ、ステップ 5 には少なくとも 1 つの RPA テンプレートが必要です。どちらも API では作成できないため、照会結果が空の場合はダッシュボードで用意してください。


### ステップ 1: アクセス トークンを取得する

```bash
curl -X POST "https://api.morelogin.com/oauth2/token" \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "YOUR_API_ID",
    "client_secret": "YOUR_API_KEY",
    "grant_type": "client_credentials"
  }'
```

*応答の `access_token` を保存します。*

### ステップ 2: クラウドフォンを作成する

```bash
curl -X POST "https://api.morelogin.com/cloudphone/create" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -d '{
    "skuId": "10002",
    "quantity": 1
  }'
```

*応答の `data[0]` をクラウドフォン ID として保存します。リソース ID は 10 進文字列です。*

### ステップ 3: クラウドフォンの電源を入れる

```bash
curl -X POST "https://api.morelogin.com/cloudphone/powerOn" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -d '{"id": "1673823102599682"}'
```

*電源投入は非同期です。成功応答は要求の受理のみを示します。オンライン状態が必要なコマンドを送る前に、端末が実行可能になるまで待ってください。*

### ステップ 4: アプリをインストールする

アプリはチームのアプリライブラリからインストールされるため、まずライブラリの内容を確認します。

```bash
curl -X POST "https://api.morelogin.com/cloudphone/app/page" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -d '{"pageNum": 1, "pageSize": 10}'
```

*`appVersionId` には `data.dataList[0].appVersionList[0].id` を使用してください。バージョンは新しい順で返ります。アプリ階層の `id` は `install` が必要とする値ではありません。`data.dataList` が空の場合は、先に MoreLogin ダッシュボードでアプリをアップロードしてください。ライブラリを初期化する API はありません。*

`appVersionId` を指定してインストールするか、パッケージ名しか分からない場合は `packageName` と `versionCode` を指定します。

```bash
curl -X POST "https://api.morelogin.com/cloudphone/app/install" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -d '{
    "id": "1673823102599682",
    "appVersionId": "1672940217990530"
  }'
```

### ステップ 5: RPA スケジュールを実行する

自分のテンプレートを一覧表示し、実行したい `id` を取得します。

```bash
curl -X POST "https://api.morelogin.com/cloudphone/rpa/template/personal/page" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -d '{"pageNo": 1}'
```

*下の `templateId` には `data.dataList[0].id` を使用します。テンプレートはダッシュボードで作成するかマーケットから取得します。API は一覧表示と実行のみを行います。*

```bash
curl -X POST "https://api.morelogin.com/cloudphone/rpa/onceTask/save" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -d '{
    "cloudPhoneId": "1673823102599682",
    "scheduleName": "Daily Login Task",
    "templateId": "987654321"
  }'
```

## 次は何ですか?

| 目標 | に行く |
|  --- | --- |
| フルブラウザプロファイル API リファレンス | [ブラウザ API](/ja/api-reference/browser/local-api) |
| 完全なクラウド電話 API リファレンス | [クラウド電話 API](/ja/api-reference/cloud-phone/open-api) |
| ADB経由で接続する | [ADB 接続ガイド](/ja/api-reference/cloud-phone/adb) |