Comprar y activar Cloud Phones mensuales

Referencia de API

Comprar y activar Cloud Phones mensuales

Request

Compra y activa de 1 a 10 Cloud Phones mensuales durante 30 días.

Aviso de cobro: esta operación descuenta realmente saldo del equipo.
Permiso: el miembro debe tener Gestión de gastos/pagos; de lo contrario se devuelve 99012.
Crear primero: crea los teléfonos con /api/cloudphone/create; la creación solo genera registros inactivos y no cobra.
Selección: los ID deben ser distintos, pertenecer al equipo y usar productos mensuales activos de 30 días. Se permiten SKU mensuales distintos. Mezclar estados u órdenes incompatibles, pedidos pendientes del cliente o compras concurrentes rechaza toda la solicitud.
Cobro y restauración: la validación y el cobro son todo o nada. Si todos pertenecen al mismo pedido pagado, se restaura el derecho existente sin volver a cobrar. Local API, Open API y el cliente comparten el estado.
Finalización: confirma 30 días para todos; no enciende teléfonos ni activa renovación.
Activación no confirmada: con 33422, data.results sigue completo y ordenado. Revisa status, expireTime y errorCode.
Reintento: tras un timeout, consulta /api/cloudphone/info o /api/cloudphone/page.

Errores documentados: 20002, 20003, 20004, 20008, 20041, 20055, 20068, 20070, 20071, 33420, 33421, 33422, 99001, 99002, 99012. Consulta Error Codes.

Versión del cliente: requiere MoreLogin Desktop v2.65.0 o posterior; las versiones anteriores no exponen esta ruta Local API.

Bodyapplication/jsonrequired

idsArray of strings, [ 1 .. 10 ] items, uniquerequired

One to ten distinct positive Cloud Phone IDs, encoded as strings to preserve 64-bit precision

curl -i -X POST \
  http://127.0.0.1:40000/api/cloudphone/monthly/activate \
  -H 'Content-Type: application/json' \
  -d '{
    "ids": [
      "1724032706822188",
      "1724032729890861"
    ]
  }'

Responses

Request processed; inspect code, and inspect data.results when returned

Bodyapplication/json

codeintegerrequired

Business result code; 0 indicates success

Example:0

msgstring or nullrequired

Error message; null when successful

Example:null

requestIdstringrequired

Request ID for troubleshooting

Example:"1d4f3ea968664593860b94b35d4ebf5e"

dataobject(MonthlyCloudPhoneActivationData)

Response

{
  "code": 0,
  "msg": null,
  "data": {
    "orderId": "1724032801202461",
    "orderStatus": 1,
    "results": [ … ]
  },
  "requestId": "db5e04c2eb804cdfb96b1469c7379bbc"
}