update
Para modificar los parámetros de una aplicación, utilice el método apps/update.
En Wialon Hosting, solo el usuario de nivel superior del servicio puede utilizar este método.
Endpoint
svc=apps/update¶ms={
"id": <long>,
"name": <text>,
"description": <text>,
"url": <text>,
"flags": <uint>,
"langs": <text>,
"sortOrder": <int>,
"requiredServicesList": <text>,
"billingPlans": <text>
}
Parámetros
La solicitud debe contener todos los siguientes parámetros. Si un parámetro no es necesario para su aplicación, indique un valor vacío ("" para los parámetros de texto y 0 para los numéricos).
| Parámetro | Descripción |
|---|---|
| id | ID de la aplicación. Puede obtenerlo con el método apps/list con "manageMode":1. |
| name | Nombre de la aplicación. No puede estar vacío. |
| description | Descripción de la aplicación. También se utiliza como descripción del servicio de la aplicación. Puede dejarla vacía. |
| url | URL donde se aloja la aplicación. Debe empezar por http://, https:// o //. |
| flags | Flags de la aplicación (parámetros avanzados de URL). Para ver los valores posibles, consulte Flags. Utilice 0 si no necesita ninguno. |
| langs | Idiomas de la interfaz para los que está disponible la aplicación, separados por comas, por ejemplo, "en,ru". Si el valor está vacío, la aplicación está disponible para todos los idiomas. |
| sortOrder | Orden de clasificación de la aplicación en la lista. |
| requiredServicesList | Nombres de los servicios requeridos para la aplicación, separados por comas. Cada servicio debe estar disponible en su cuenta. No agregue una coma al final de la lista. Puede dejarlo vacío. |
| billingPlans | Nombres de los planes de facturación para los que está disponible la aplicación, separados por comas. Cada plan de facturación debe existir en su servicio. Puede dejarlo vacío. |
Todos los parámetros se sustituyen por los nuevos valores. Para conservar el valor actual de un parámetro, indíquelo en la solicitud. Puede obtener los valores actuales con el método apps/list con "manageMode":1.
Si modifica el parámetro billingPlans, el servicio app.<serviceName> (el servicio Visualización en el menú: <nombre de la aplicación> en CMS Manager) se agrega a los nuevos planes de facturación y se elimina de los planes de facturación que quitó de la lista.
Respuesta
Si la solicitud se completa con éxito, la respuesta se devuelve en el siguiente formato:
[
<long>, /* ID de la aplicación */
{
"name": <text>, /* Nombre de la aplicación */
"description": <text>, /* Descripción de la aplicación */
"url": <text>, /* URL de la aplicación */
"flags": <uint>, /* Flags de la aplicación */
"sortOrder": <int>, /* Orden de clasificación */
"serviceName": <text>, /* Nombre del servicio de la aplicación sin el prefijo "app." */
"id": <long>, /* ID de la aplicación */
"langs": <text>, /* Idiomas de la interfaz */
"requiredServicesList": <text>, /* Servicios requeridos */
"billingPlans": <text> /* Planes de facturación */
}
]
Si la solicitud falla, se devuelve un código de error.
Códigos de error
| Código de error | Descripción |
|---|---|
| 4 | Parámetros de entrada incorrectos o falta uno de los parámetros. |
| 7 | Acceso denegado: el usuario no es el usuario de nivel superior del servicio o el servicio no es Wialon Hosting. Este código también se devuelve si no se encontró la aplicación con el ID indicado, el nombre o la URL son incorrectos, un servicio requerido o un plan de facturación no está disponible o no se puede modificar la aplicación. |