Створення профілю хмарного телефону

Довідник API

Створення профілю хмарного телефону

Request

Купує та готує один або кілька хмарних телефонів.

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

Задокументовані бізнес-помилки: 19064, 20018, 33338, 33339, 33340, 33341, 33342, 33343, 33344, 33345, 33398, 33399, 33400, 33408. Значення кодів див. у Error Codes. Будь-яка операція може додатково повернути загальні коди.

Bodyapplication/jsonrequired

skuIdstringrequired

Модель хмарного телефона

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

Підтримувані регіони та відповідність часових поясів див. у таблиці країн і часових поясів

quantityinteger, [ 1 .. 10 ]required

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

envRemarkstring, <= 1500 characters

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

groupIdstring

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

groupNamestring, <= 50 characters

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

automaticGeoboolean

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

automaticLanguageboolean

Чи підбирати мову автоматично. За замовчуванням: true

automaticLocationboolean

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

countrystring

Код країни (наприклад us). Повний список див. у таблиці країн і часових поясів

timezonestring

Часовий пояс, наприклад America/New_York

languagestring

Мова, наприклад en-US

altitudenumber

Висота над рівнем моря

latitudenumber

Широта. Приклад: 22.309182

longitudenumber

Довгота. Приклад: 114.176817

speednumber, <= 400

Швидкість руху

bearingnumber, <= 360

Напрямок руху

accuracynumber, <= 100

Горизонтальна точність

phoneNumberstring

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

brandstring

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

modelIdnumber

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

proxyIdstring

ID проксі

tagsArray of strings

Назви міток. Порожні значення ігноруються.

curl -i -X POST \
  http://127.0.0.1:40000/api/cloudphone/create \
  -H 'Content-Type: application/json' \
  -d '{
    "skuId": "1661515884160372",
    "quantity": 1
  }'

Responses

Bodyapplication/json

codeintegerrequired

msgstring or nullrequired

dataArray of strings

Це хмарна система ідентифікації телефону

requestIdstringrequired

errorobject

Response

{
  "code": 0,
  "msg": null,
  "data": [
    "string"
  ],
  "requestId": "0d8b6f1c-9f4e-4d02-9d1a-7c3f5a1b2c3d",
  "error": {}
}