# Знімок екрана хмарного телефону

Робить знімок екрана хмарного телефона й повертає URL для завантаження.
- **Передумови**: хмарний телефон повинен бути увімкнений і не може бути зайнятий іншим учасником команди. Підтримується лише на сумісних пристроях; решта Сервісів відхиляють виклик.
- **Ефект**: На деяких моделях файл знімка видаляється з пристрою після того, як його зроблено.
- **Завершення**: синхронне. Відповідь містить тимчасовий URL для завантаження зображення.
- **Особливість**: На деяких моделях повідомлений термін спливання — фіксована година від моменту відповіді, а `success` завжди дорівнює true; це не справжній термін життя підпису. Завантажуйте зображення відразу, а не зберігайте URL.
- **Повтор**: побічних ефектів, крім самого знімка, немає, тому повторювати безпечно.

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

## Request fields (application/json):

  - `id` (string, required)
    Ідентифікатор хмарного телефона
    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)
    Успішно згенеровано
    Example: true

  - `msg` (string | null)
    Повідомлення; заповнюється за code > 0

  - `requestId` (string)
    Унікальний ідентифікатор запиту; вкажіть його при зверненні до підтримки