Стартап облачного телефона

Справочник API

Стартап облачного телефона

Request

Включает облачный телефон.

Предварительные условия: телефон должен быть выключен. Вызов отклоняется, когда SKU снят с продажи или на обслуживании, когда телефон занят другим участником, пока проверяется его прокси, когда на счёте задолженность или телефон деактивирован, когда истёк месячный период, а также когда недоступны ни бесплатные минуты, ни параллельный слот, ни положительный баланс. Некоторые модели дополнительно требуют последнюю версию клиента для Windows.
Эффект: помечает телефон как загружающийся, занимает его для вызывающего участника и резервирует параллельный слот либо начинает расходовать время. Ответ сообщает, что именно было использовано.
Завершение: принято, но не завершено. Опрашивайте /cloudphone/info, пока envStatus не станет «включён»; ошибка проявится там как errorCode и errorMsg. Участники с настроенным хостом обратного вызова также получают webhook.
Повтор: второй одновременный вызов отклоняется сразу, а не ставится в очередь. После таймаута прочитайте /cloudphone/info, а не отправляйте запрос заново.

Задокументированные бизнес-ошибки: 33300, 33309, 33315, 33316, 33317, 33318, 33321, 33322, 33323, 33324, 33325, 33346, 33347, 33367, 33376, 33407. Значения кодов см. в Error Codes. Любая операция может дополнительно вернуть общие коды.

Security

Authorization

Bodyapplication/jsonrequired

idstringrequired

disableMoneySavingModeboolean

Отключить режим энергосбережения, по умолчанию: false

curl -i -X POST \
  https://api.morelogin.com/cloudphone/powerOn \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "1637226321190925"
  }'

Responses

Bodyapplication/json

codeintegerrequired

Возвращаемый код результата 0: Нормальный. Остальные коды являются исключениями.

msgstring or nullrequired

Сообщение об ошибке

requestIdstringrequired

Идентификатор запроса на операцию

Response

{
  "code": 0,
  "msg": null,
  "requestId": "0d8b6f1c-9f4e-4d02-9d1a-7c3f5a1b2c3d"
}