update

Este método se utiliza para gestionar sus propios tokens y los tokens de los usuarios a los que tiene acceso. El método no se utiliza para la autorización. Para iniciar sesión, utilice token/login.

Para crear, modificar o eliminar un token, utilice el método token/update:

Copied!

svc=token/update&params={"callMode":<text>,
             "userId":<text>,
             "h":<text>,
             "app":<text>,
             "at":<uint>,
             "dur":<uint>,
             "fl":<uint>,
             "p":<text>,
             "items":[<long>],
             "deleteAll":<bool>|<text>
        }

Parámetros

La solicitud puede contener los siguientes parámetros. Los parámetros obligatorios están marcados con un asterisco (*).

Nombre	Descripción
`callMode`*	Acción que desea realizar. Para crear un token, especifique `create` en este parámetro. Para modificar un token, pase `update`, y para eliminarlo, pase `delete`.
`userId`	ID del usuario subordinado. El parámetro se utiliza para gestionar los tokens de otros usuarios.
`h`*	Nombre del token. Consta de 72 caracteres. Este parámetro debe utilizarse en las solicitudes para modificar y eliminar un token.
`app`*	Nombre de la aplicación.
`at`*	Hora de activación del token, tiempo UNIX. Puede pasar 0 en este parámetro para que el token se active inmediatamente después de que la solicitud se complete con éxito.
`dur`*	Duración del token después de la activación, segundos. Pase 0 en este parámetro para establecer una duración ilimitada.
`fl`*	Flags de acceso.
`p`*	Parámetros personalizados; el valor debe ser un objeto o un array de objetos.
`items`	Lista de los ID de los elementos a los que el token otorga acceso.
`deleteAll`	Relevante para `"callMode":"delete"`. Pase `1` o `true` para eliminar todos los tokens creados.

Los tokens se eliminan automáticamente después de 100 días de inactividad (incluso con "dur":0).

Ejemplo de un objeto para el parámetro p:

Copied!

"p":"{\"paramA\":\"valueB\"}"

Ejemplo de un array de objetos para el parámetro p:

Copied!

"p":"[{\"paramA\":\"valueB\"},{\"paramB\":\"valueD\"}]"

Flags de acceso

Flag en HEX	Flag en DEC	Descripción
0x100	256	Rastreo en línea.
0x200	512	Acceso de visualización a la mayoría de los datos.
0x400	1024	Modificación de datos no sensibles.
0x800	2048	Modificación de datos sensibles.
0x1000	4096	Modificación de datos críticos, incluida la eliminación de mensajes.
0x2000	8192	Comunicación con la unidad (envío de comandos) y modificación de asuntos.
0x4000	16384	Administración de códigos de activación de unidades y grupos de unidades. El flag funciona solo en los servicios con la función de códigos de activación habilitada (consulte Códigos de activación de unidades).
-1	-1	Operación ilimitada como usuario autorizado (permite gestionar los tokens del usuario).

Para obtener más información sobre los flags de token, consulte Tokens.

Respuesta

Si la solicitud se completa con éxito, la respuesta se devuelve en el siguiente formato:

Copied!

{
    "h":<text>,       /* Nombre único del token, 72 caracteres. */
    "app":<text>,     /* Nombre de la aplicación. */
    "at":<uint>,      /* Hora de activación del token, tiempo UNIX. */
    "ct":<uint>,      /* Hora de creación del token, tiempo UNIX. */
    "dur":<uint>,     /* Duración del token después de la activación, segundos. */
    "fl":<uint>,      /* Flags de acceso. */
    "items":[<long>], /* Lista de los ID de los elementos a los que el token otorga acceso. */
    "p":<text>        /* Parámetros personalizados. El valor debe ser un objeto o un array de objetos. */
}

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.
1003	Se alcanzó el límite de solicitudes.
7	Uno de los siguientes errores: Token incorrecto. No se encontró el token del usuario. No se pudo eliminar el token. No hay derecho de acceso Actuar en nombre del usuario al usuario.