# クラウドフォンのリモート接続リンクを作成

クラウドフォンにブラウザでアクセスするための一時リンクを作成します（Open API のみ）。
- **前提条件**：端末が現在のチームに属し、呼び出すメンバーにアクセス権限があり、起動済みで、他のメンバーに使用されていないことが必要です。自動起動は行いません。
- **効果**：呼び出すたびに新しいリンクを作成します。接続認証情報の取得や現在の接続の変更は行いません。ブラウザで `data.url` を開くか、URL 全体を QR コードに変換してください。
- **有効期間**：作成から固定で 5 分です。繰り返しアクセスしてもリンクは消費されず、有効期間も延長されません。期限切れ後は API を再度呼び出してください。`expiredTime` は返されません。この期間は接続認証情報の有効期間を示すものではありません。
- **接続**：アクセスが成功するたびに新しい認証情報を取得し、リモート操作ページへリダイレクトします。以前の接続に影響する場合があります。アクセスに失敗した場合は有効期間内に再試行できます。リンクの作成成功は、その後の接続成功を保証しません。
- **管理**：URL 全体を機密情報として扱ってください。応答には `Cache-Control: no-store` が含まれます。返された URL をそのまま使用してください。ホストと接続パラメーターはサーバーが決定します。

文書化されたビジネスエラー: `33300`, `33301`, `99002`。 各コードの意味は [Error Codes](../Getting%20Started/error-codes.md) を参照してください。どの操作でも共通コードが返る場合があります。

Endpoint: POST /cloudphone/link
Version: 2026-09-05
Security: Authorization

## Security:

  - `Authorization` (unknown)
    http bearer JWT

## Request fields (application/json):

  - `id` (string, required)
    MoreLogin のクラウドフォン ID。

  - `lang` (string)
    ページの言語（例：`zh-CN`、`en-US`）。省略または空白の場合はリクエストの言語を使用し、未対応の値は設定済みの既定言語にフォールバックします。選択した言語は URL に含まれ、クエリパラメーター `lang` を変更するとページの言語を切り替えられます。

## Response 200:

  - `200` (unknown)
    成功。`data.url` は 5 分間有効な一時ブラウザアクセスリンクです。

## Response 200 fields (application/json):

  - `code` (integer, required)
    Example: 0

  - `msg` (string | null, required)
    Example: null

  - `data` (object, required)

  - `data.url` (string, required)
    一時ブラウザアクセス URL。URL 全体を機密の認証情報として扱ってください。
    Example: https://gateway.example.com/app/cloudphone/qrcodeUrl?token=0123456789abcdef0123456789abcdef&lang=en-US

  - `requestId` (string)

## Response 200 headers (application/json):

  - `Cache-Control` (string)
    この応答をキャッシュしないでください。
    Enum: "no-store"