Crear un horario único

Referencia de API

Request

Guardar el teléfono en la nube una vez programada la tarea

Especificación de parámetros de plantilla

Origen de los parámetros Las claves de los parámetros deben extraerse del campo parameter que devuelven las siguientes API:

Obtener páginas de plantillas de mercado
Obtener páginas de plantillas personales

Estructura de datos

Enviar parámetros en formato de objeto JSON: {"clave1": "valor1", "clave2": "valor2"}
Los valores finales de los parámetros deben deserializarse según la lógica de negocio antes de su uso.

Parámetros de tipo común Para los siguientes tipos de parámetros, pasar los valores directamente en el formato correspondiente:

Cadena: {"nombre": "John"}
Decimal/número: {"cantidad": 100.50}
Booleano: {"habilitado": true}

Parámetros de tipo de medio Para parámetros de medios como imágenes o vídeos, además de la información básica, debe incluirse una clave fija "__Extra__". Formato de ejemplo:

{
"__Extra__": {
"pic": {
"name": "pic_name",
"size": 204800

},
"video": {
"name": "video_name",
"size": 204800000
}

},
"pic": "https://get.morelogin.com/prod/cloudPhoneTaskVideo/1556061681934880/1c62314c7e2b4d298abe8d5452d7c050/test.png",
"video": "morelogin://cloudfile?ids=1,2"
}

Ejemplo de configuración de parámetros El siguiente ejemplo muestra cómo configurar el parámetro templateParameter al guardar un plan usando una plantilla de mercado:

Paso 1: Recuperar parámetros de la plantilla Llamar a la API de plantillas de mercado: GET /api/cloudphone/rpa/template/market/page Extraer el campo parameter de la respuesta, por ejemplo:

"parameter": "{\"videoDownloadUrl\":{\"type\":\"video\",\"extra\":{\"name\":\"Select" Vídeo\",\"tipo\":\"vídeo\",\"obligatorio\":verdadero,\"valor_predeterminado\":{\"habilitado\":falso},\"índice\":1,\"límite_tamaño\":{\"valor\":200,\"unidad\":\"MB\"},\"tipo_formato\":[\"mp4\",\"mov\"]}},\"descripción_vídeo\":{\"tipo\":\"cadena\",\"extra\":{\"nombre\":\"Vídeo Leyenda\",\"tipo\":\"cadena\",\"obligatorio\":false,\"carácter\":{\"habilitado\":true,\"valor\":1000},\"multilínea\":{\"habilitado\":true,\"valor\":3},\"valor\predeterminado\":{\"habilitado\":false},\"índice\":2}},\"url\de\portada\":{\"tipo\":\"imagen\",\"extra\":{\"nombre\":\"Portada" Imagen\",\"tipo\":\"imagen\",\"obligatorio\":false,\"valor_predeterminado\":{\"habilitado\":false},\"índice\":3,\"límite_tamaño\":{\"valor\":5,\"unidad\":\"MB\"},\"tipo_formato\":[\"jpg\",\"png\",\"jpeg\"]}},\"habilitarAIGC\":{\"tipo\":\"booleano\",\"extra\":{\"nombre\":\"Etiqueta_AI\",\"tipo\":\"booleano\",\"obligatorio\":false,\"valor_predeterminado\":{\"habilitado\":false},\"índice\":4}},\"id_producto\":{\"tipo\":\"cadena\",\"extra\":{\"nombre\":\"Producto ID\",\"type\":\"string\",\"required\":false,\"charValid\":{\"enabled\":true,\"value\":50},\"placeholder\":\"El ID del producto solo admite dígitos, con un máximo de 50 caracteres."\"defaultValue\":{\"enabled\":false},\"index\":5}},\"productTitle\":{\"type\":\"string\",\"extra\":{\"name\":\"Producto Título\",\"tipo\":\"cadena\",\"obligatorio\":falso,\"carácterValidado\":{\"habilitado\":verdadero,\"valor\":30},\"valorPredeterminado\":{\"habilitado\":falso},\"índice\":6}},\"obtenerClientes Potenciales\":{\"tipo\":\"booleano\",\"extra\":{\"nombre\":\"Obtener "Clientes potenciales\",\"tipo\":\"booleano\",\"obligatorio\":falso,\"valor_predeterminado\":{\"habilitado\":falso},\"índice\":7}},\"comentario\":{\"tipo\":\"cadena\",\"extra\":{\"nombre\":\"Comentario\",\"tipo\":\"cadena\",\"obligatorio\":falso,\"caracter_validado\":{\"habilitado\":verdadero,\"valor\":200},\"multilínea\":{\"habilitado\":verdadero,\"valor\":3},\"valor_predeterminado\":{\"habilitado\":falso},\"índice\":8}}}"

Paso 2: Construir el JSON de parámetros Construir el objeto JSON según los requisitos de los parámetros:

{
"__Extra__": {
"videoDownloadUrl": {
"name": "video_name.mp4",
"size": 204800000
}

},
"videoDownloadUrl": "morelogin://cloudfile?ids=1,2"
}
``` - __Paso 3: Escapar la cadena JSON__
Convierte el objeto JSON a un formato de cadena escapada:
```json
"{\"__Extra__\": {\"videoDownloadUrl\": {\"name\": \"video_name.mp4\",\"size\": 204800000}},\"videoDownloadUrl\": "morelogin://cloudfile?ids=1,2"
Paso 4: Llamada a la API
Pase la cadena escapada como valor del parámetro `templateParameter` a la API de destino.

Errores de negocio documentados: `33814`, `33818`. Consulte [Error Codes](../Getting%20Started/error-codes.md) para el significado de cada código. Cualquier operación puede devolver además los códigos comunes.

Security

Authorization

Bodyapplication/jsonrequired

cloudPhoneIdstringrequired

ID de teléfono en la nube

scheduleNamestringrequired

Nombre del horario

templateIdstringrequired

ID de plantilla, plantilla personal o ID de plantilla de mercado

templateParameterstring

Los parámetros de la plantilla se definen en plantillas personales o plantillas de mercado. Los parámetros en la plantilla se definen como: {"Test":{"extra":{"type":string","required":true,"multiline":{"enabled":false},"name":Test","index":1},"type":string"}} Al solicitar parámetros, el parámetro que se pasa es: {"Test":xxxx"}

descriptionstring

Descripción del horario

curl -i -X POST \
  https://api.morelogin.com/cloudphone/rpa/onceTask/save \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "cloudPhoneId": "16783319661123",
    "scheduleName": "test",
    "templateId": "1678347487160256",
    "templateParameter": "{\"keyword\": \"abc\"}",
    "description": "descripción del horario"
  }'

Responses

Correcto. data es un único valor entero.

Headers

any

Bodyapplication/json

codeintegerrequired

Código de respuesta: 0 indica éxito, >0 indica fallo

msgstring or nullrequired

Mensaje de error

requestIdstringrequired

ID de seguimiento de la solicitud

dataintegerrequired

ID de horarios

Response

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