# Створення хмарного телефону

Купує та готує один або кілька хмарних телефонів.
- **Передумови**: у тарифі має залишитися ємність, а добова квота створення не має бути витрачена. `country`, `timezone` і `language` перевіряються за списком, який підтримує вибраний Сервіс, тому непідтримувана комбінація відхиляється, а не підганяється непомітно. Координати обмежені ±180 за довготою та ±90 за широтою. Номер телефона відкидається, якщо вибраний SKU його не підтримує. Місячні SKU можна створювати через API, якщо їх повертає [`/cloudphone/monthly/skus`](./open-api.yaml#operation/listMonthlyCloudPhoneSkus); поточний період — 30 днів.
- **Ефект**: створює записи хмарних телефонів. SKU з похвилинною оплатою стають доступними після підготовки; місячні створюються неактивними. Створення не списує кошти: місячні телефони оплачуються лише через [`/cloudphone/monthly/activate`](./open-api.yaml#operation/activateMonthlyCloudPhones), а похвилинні починають витрачати баланс або квоту після ввімкнення.
- **Завершення**: **прийнято, але не завершено.** Інстанс Сервіса ще не готовий, а надто раннє увімкнення відхиляється. Опитуйте [`/cloudphone/info`](./open-api.yaml#operation/infoUsingPOST) або [`/cloudphone/page`](./open-api.yaml#operation/pageUsingPOST), доки `envStatus` не повідомить, що телефон вимкнений. Для місячного SKU перед увімкненням також виконайте [`/cloudphone/monthly/activate`](./open-api.yaml#operation/activateMonthlyCloudPhones).
- **Повтор**: не ідемпотентний і не серіалізується. Ключа ідемпотентності немає. Не повторюйте наосліп після таймауту: спершу запитайте стан.

Задокументовані бізнес-помилки: `19064`, `20018`, `33338`, `33339`, `33340`, `33341`, `33342`, `33343`, `33344`, `33345`, `33398`, `33399`, `33400`, `33408`. Значення кодів див. у [Error Codes](../Getting%20Started/error-codes.md). Будь-яка операція може додатково повернути загальні коди.

Endpoint: POST /cloudphone/create
Version: 2026-09-05
Security: Authorization

## Security:

  - `Authorization` (unknown)
    http bearer JWT

## Request fields (application/json):

  - `skuId` (string, required)
    Модель хмарного телефона
| Модель хмарного телефона | SKU ID (`skuId`) |
|  --- | --- |
| Android 12 | `10002` |
| Android 13 | `10013` |
| Android 14 | `10005` |
| Android 15 | `10004` |
| Android 15A | `10014` |
| Android 16 | `10015` |
| Android 17 | `10105` |

Підтримувані регіони та відповідність часових поясів див. у [таблиці країн і часових поясів](/api-reference/appendix/country-time-zone)

  - `quantity` (integer, required)
    Кількість хмарних телефонів, що створюються. Діапазон значень: [1-10]

  - `envRemark` (string)
    Примітка до профілю (не більше 1500 символів)

  - `groupId` (string)
    ID групи. Для «без групи» вкажіть `"0"`.

  - `groupName` (string)
    Назва наявної групи або назва нової групи, яку буде створено, якщо збігів немає.

  - `automaticGeo` (boolean)
    Чи підбирати географічне розташування автоматично. За замовчуванням: true

  - `automaticLanguage` (boolean)
    Чи підбирати мову автоматично. За замовчуванням: true

  - `automaticLocation` (boolean)
    Чи підбирати розташування (часовий пояс, країну) автоматично. За замовчуванням: true

  - `country` (string)
    Код країни (наприклад `us`). Повний список див. у [таблиці країн і часових поясів](/api-reference/appendix/country-time-zone)

  - `timezone` (string)
    Часовий пояс, наприклад America/New_York

  - `language` (string)
    Мова, наприклад en-US

  - `altitude` (number)
    Висота над рівнем моря

  - `latitude` (number)
    Широта. Приклад: 22.309182

  - `longitude` (number)
    Довгота. Приклад: 114.176817

  - `speed` (number)
    Швидкість руху

  - `bearing` (number)
    Напрямок руху

  - `accuracy` (number)
    Горизонтальна точність

  - `phoneNumber` (string)
    Власний номер телефона. Вимоги до формату: має починатися зі знака +, код країни — від 1 до 3 цифр (крім 86), загальна довжина — від 8 до 14 цифр, допустимі лише + та цифри.

  - `brand` (string)
    Бренд пристрою. Його можна запитати через інтерфейс https://guide.morelogin.com/api-reference/open-api/open-api/cloud-phone/paths/~1cloudphone~1brand~1models/post.

  - `modelId` (number)
    ID моделі пристрою. Його можна запитати через інтерфейс https://guide.morelogin.com/api-reference/open-api/open-api/cloud-phone/paths/~1cloudphone~1brand~1models/post.

  - `proxyId` (string)
    ID проксі

  - `tags` (array)
    Назви міток. Порожні значення ігноруються.

## Response 200:

  - `200` (unknown)
    OK

## Response 200 fields (application/json):

  - `code` (integer, required)

  - `msg` (string | null, required)

  - `data` (array)
    Це хмарна система ідентифікації телефону

  - `requestId` (string, required)

  - `error` (object)