コンテンツへスキップ
API リファレンス
/
ブラウザ
/
/Cloud Runtime

Cloud Runtime

MoreLogin クラウドで動作するブラウザープロファイルの起動、停止、照会、接続を行います。

Operations

クラウドランタイムを起動

Request

ブラウザープロファイルをクラウドランタイムとして起動します。

  • 前提条件：プロファイルが自チームに存在し、エンドツーエンド暗号化されておらず、移管中でもないこと。プロキシが必須で、起動が受理される前にその到達性が検査されます。ブラウザーカーネルはクラウドブラウザーが対応するものでなければならず、これにより Firefox は除外されます。チームの同時オープン上限が適用され、クラウドブラウザー課金が有効な環境では AI クレジット残高も検査されます。
  • 1 プロファイルに 1 実行：1 人のメンバーが 1 プロファイルにつき保持できる実行は 1 つだけです。チームがセキュリティロックを有効にしている場合、他のメンバーの実行が自分の起動を妨げます。
  • 完了シグナル：受理されただけで、完了ではありません。 data は空です。ランタイムは非同期に用意されます。/cloudbrowser/page をポーリングし cloudBrowserStatus が RUNNING になったら、/cloudbrowser/connect を呼んで cdpUrl を取得してください。起動が受理された後に失敗することもあり、その場合はそのページに現れます。
  • 同時実行：1 プロファイルへの同時起動はロックで直列化され、競合に負けた側はキューに入らず拒否されます。
  • リトライ：タイムアウト後は /cloudbrowser/page を読んでください — 再送信しないこと。

文書化されたビジネスエラー: 19039, 19065, 40001, 40003, 40015, 40016, 40021, 40023, 40024, 40025, 40026, 40027, 40028, 40029, 40037。 各コードの意味は Error Codes を参照してください。どの操作でも共通コードが返る場合があります。

Security
OpenApiBearer
Bodyapplication/jsonrequired
envIdstring(EnvironmentId)^[1-9]\d*$required

Browser profile (environment) ID. Serialized as a decimal string to avoid JavaScript precision loss on 64-bit integers.

Example:"1800000000000001"
curl -i -X POST \
  https://api.morelogin.com/cloudbrowser/start \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "envId": "1800000000000001"
  }'

Responses

Success

Bodyapplication/json
codeintegerrequired

Return result code. 0 means success; other codes indicate exceptions.

Example:0
msgstring or nullrequired

Error message. Usually null on success.

Example:null
requestIdstring

Operation request ID. This field may be present when the request passes through the API gateway.

Example:"1d4f3ea968664593860b94b35d4ebf5e"
datanull
Example:null
Response
{
  "code": 0,
  "msg": null,
  "requestId": "1d4f3ea968664593860b94b35d4ebf5e",
  "data": null
}