Создать ссылку удалённого подключения к облачному телефону

Справочник API

Создать ссылку удалённого подключения к облачному телефону

Request

Создаёт временную ссылку для доступа к облачному телефону через браузер (только Open API).

Условия: телефон принадлежит вашей команде, доступен вызывающему участнику, включён и не занят другим участником. API не включает телефон автоматически.
Эффект: каждый вызов создаёт новую ссылку без запроса учётных данных подключения и без изменения текущего подключения. Откройте data.url в браузере или создайте QR-код из полного URL.
Срок действия: ровно 5 минут с момента создания. Повторные переходы не расходуют и не продлевают ссылку. После истечения вызовите API снова. Поле expiredTime не возвращается; этот срок не относится к учётным данным подключения.
Подключение: каждый успешный переход запрашивает новые учётные данные подключения и перенаправляет на страницу управления; это может повлиять на предыдущее подключение. Неудачный переход можно повторить до истечения срока. Создание ссылки не гарантирует успешное последующее подключение.
Хранение: сохраняйте полный URL в тайне. Ответ содержит Cache-Control: no-store. Используйте возвращённый URL без изменений; адрес и параметры подключения определяет сервер.

Задокументированные бизнес-ошибки: 33300, 33301, 99002. Значения кодов см. в Error Codes. Любая операция может дополнительно вернуть общие коды.

Security

Authorization

Bodyapplication/jsonrequired

idstringrequired

ID облачного телефона MoreLogin.

langstring

Язык страницы, например zh-CN или en-US. Если значение отсутствует или пустое, используется язык запроса; неподдерживаемые значения заменяются настроенным языком по умолчанию. Язык включён в URL; параметр запроса lang можно изменить для переключения языка страницы.

curl -i -X POST \
  https://api.morelogin.com/cloudphone/link \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "1710784536928649",
    "lang": "en-US"
  }'

Responses

Успешно. data.url — временная ссылка для браузера, действительная 5 минут.

Headers

Cache-Controlstring

Не кешируйте этот ответ.

Value:"no-store"

Bodyapplication/json

codeintegerrequired

Example:0

msgstring or nullrequired

Example:null

dataobjectrequired

requestIdstring

Response

{
  "code": 0,
  "msg": null,
  "data": {
    "url": "https://gateway.example.com/app/cloudphone/qrcodeUrl?token=0123456789abcdef0123456789abcdef&lang=en-US"
  },
  "requestId": "0d8b6f1c-9f4e-4d02-9d1a-7c3f5a1b2c3d"
}