# クラウドフォンのスクリーンキャプチャ

クラウドフォンの画面をキャプチャし、ダウンロード URL を返します。
- **前提条件**：クラウドフォンが起動済みで、他のメンバーに占有されていないこと。対応機種でのみ対応。非対応の機種では呼び出しが拒否されます。
- **副作用**：一部の機種ではキャプチャ後にスクリーンショットファイルが端末から削除されます。
- **完了シグナル**：同期的です。レスポンスに画像の一時ダウンロード URL が含まれます。
- **注意**：一部の機種では返却される有効期限がレスポンスから固定 1 時間となり、`success` は常に true です — これは実際の署名の有効期間ではありません。URL を保存せず、速やかにダウンロードしてください。
- **リトライ**：キャプチャ自体以外の副作用はないため、繰り返しても安全です。

Endpoint: POST /api/cloudphone/screenCap
Version: 2026-09-05

## Request fields (application/json):

  - `id` (string, required)
    クラウドフォン ID
    Example: 1558968155668507

## Response 200:

  - `200` (unknown)
    成功。`data` は `url`、`status`、`expireAt`、`success` のフィールドを持つオブジェクトです。

## Response 200 fields (application/json):

  - `code` (integer)
    レスポンスコード: 0 = 成功、>0 = エラー

  - `data` (object)

  - `data.url` (string)
    スクリーンショットのアクセス URL
    Example: http://oss.morelogin.com/test.png

  - `data.status` (string)
    即時完了（"finish"）か保留中（"pending"）かを表す状態
    Example: finish

  - `data.expireAt` (string)
    URL の有効期限タイムスタンプ（ミリ秒、一部の機種のみ）
    Example: 1756024767163

  - `data.success` (boolean)
    Whether the URL was successfully generated
    Example: true

  - `msg` (string | null)
    メッセージ。code > 0 のときに返ります

  - `requestId` (string)
    リクエストの一意な識別子。サポートへの問い合わせ時に提示してください