# Створити посилання віддаленого підключення до хмарного телефона

Створює тимчасове посилання для доступу до хмарного телефона через браузер (лише Open API).
- **Умови**: телефон належить вашій команді, доступний учаснику, який викликає API, увімкнений і не зайнятий іншим учасником. API не вмикає телефон автоматично.
- **Дія**: кожен виклик створює нове посилання без запиту облікових даних підключення та зміни поточного підключення. Відкрийте `data.url` у браузері або створіть QR-код із повного URL.
- **Строк дії**: рівно 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)
    ID хмарного телефона MoreLogin.

  - `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"