コンテンツへスキップ
API リファレンス
/
/
クイックスタート
Last updated

クイックスタート

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

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

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

前提条件

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

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

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: プロファイルを開始してデバッグ ポートを取得する

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)

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: プロファイルを停止する

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: アクセス トークンを取得する

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: クラウドフォンを作成する

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: クラウドフォンの電源を入れる

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

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

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

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

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 を指定します。

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 を取得します。

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 は一覧表示と実行のみを行います。

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
完全なクラウド電話 API リファレンスクラウド電話 API
ADB経由で接続するADB 接続ガイド

Authentication

Common Response Format