login

Para iniciar sesión con un token, utilice el método token/login.

Para obtener un token, utilice los formularios descritos en Obtener un token de acceso.

Endpoint

Copied!
svc=token/login&params={
  "token": <text>,
  "operateAs": <text>,
  "fl": <uint>
}

Parámetros

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

Parámetro Descripción
token* Nombre único del token. Consta de 72 caracteres.
operateAs Nombre del usuario subordinado con el que se inicia sesión. El parámetro es opcional.
fl* Flags de respuesta (consulte a continuación).

Flags de respuesta

El parámetro fl puede contener los siguientes flags:

Flag en HEX Flag en DEC Descripción
0x1 1 Información básica.
0x2 2 Información del usuario.
0x4 4 Información del token.
0x8 8 Información sobre los elementos.
0x10 16 Información sobre los servicios de facturación.
0x20 32 Propiedades personalizadas del usuario.
0x40 64 URL del sistema de rastreo y del sistema de gestión.

Cómo obtener el nombre de un token

Para obtener el nombre del token, realice una de las siguientes acciones:

  • Cree un token nuevo con el método token/update y "callMode": "create".
  • Si ya se crearon tokens, ejecute el método token/list.

No se puede iniciar sesión con un token no activado (parámetro at en los parámetros del token).

Respuesta

Si la solicitud se completa con éxito, la respuesta incluye además el parámetro token, cuyo valor contiene todos los parámetros del token. Se devuelve una respuesta con el siguiente formato:

Copied!
{
  "host": <text>,                   /* Host. */
  "eid": <text>,                    /* ID de sesión. */
  "gis_sid": <text>,                /* ID de sesión para servicios GIS. */
  "au": <text>,                     /* Nombre de usuario. */
  "tm": <uint>,                     /* Hora actual (UTC). */
  "wsdk_version": <text>,           /* Versión del SDK. */
  "base_url": <text>,               /* URL del servidor de Wialon SDK, vacía si no está configurada. */
  "hw_gw_ip": <text>,               /* Dirección IP del servidor al que los dispositivos envían datos. */
  "hw_gw_dns": <text>,              /* Nombre de dominio del servidor al que los dispositivos envían datos. */
  "gis_search": <text>,             /* URL de búsqueda GIS. */
  "gis_render": <text>,             /* URL de renderizado GIS. */
  "gis_geocode": <text>,            /* URL de geocodificación GIS. */
  "gis_routing": <text>,            /* URL de enrutamiento GIS. */
  "billing_by_codes": <text>,       /* Códigos de activación: "1" si están habilitados, "0" si no lo están. */
  "drivers_feature_flags": <text>,  /* Flags de funciones de conductores de la cuenta. */
  "feature_flags": <text>,          /* Flags de funciones de la cuenta en formato JSON (solo si están configurados). */

  "user": {                         /* Usuario en cuyo nombre desea iniciar sesión. Se devuelve con el flag 0x2. */
    "nm": <text>,         /* Nombre. */
    "cls": <uint>,        /* ID de la superclase "user". */
    "id": <long>,         /* ID. */
    "prp": {              /* Propiedades personalizadas (se devuelven con el flag 0x20), por ejemplo: */
      "dst": <text>,       /* Horario de verano. */
      "language": <text>,  /* Idioma (código de dos letras). */
      "msakey": <text>,    /* Clave de acceso al sitio móvil. */
      "pcal": <text>,      /* Calendario iraní. */
      "tz": <text>,        /* Zona horaria. */
      "us_units": <text>,  /* Sistema de medida estadounidense (millas y galones). */
      ...
    },
    "crt": <uint>,        /* ID del creador. */
    "bact": <uint>,       /* ID de la cuenta. */
    "fl": <uint>,         /* Flags de usuario. */
    "hm": <text>,         /* Máscara de host. */
    "uacl": <uint>,       /* Acceso del usuario a su propia cuenta. */
    "mu": <uint>,         /* Sistema de medida. */
    "ct": <uint>,         /* Fecha de creación del usuario. */
    "ftp": { <text> },    /* Ajustes de FTP. */
    "ld": <uint>,         /* Fecha del último inicio de sesión. */
    "pfl": <uint>,        /* Flag del creador. */
    "ap": {               /* Ajustes de la autenticación de dos factores. */
      "type": <uint>,  /* Tipo de autenticación (0: ninguna, 1: email, 2: SMS). */
      "phone": <text>  /* Número de teléfono. */
    },
    "mapps": { <text> },  /* Lista de aplicaciones móviles. */
    "mappsmax": <int>     /* Restricciones de aplicaciones móviles especificadas en el plan de facturación. */
  },

  "token": "{\"app\":\"<text>\",\"ct\":<uint>,\"at\":<uint>,\"dur\":<uint>,\"fl\":<uint>,\"p\":\"<text>\",\"items\":[<long>]}",
                                    /* Todos los ajustes del token como JSON escapado. Se devuelve con el flag 0x4. */
  "th": <text>,                     /* Nombre del token, igual al parámetro token de la solicitud. Se devuelve con el flag 0x4. */

  "classes": {                      /* Superclases disponibles para el usuario actual (clave: nombre de la superclase, valor: ID de la superclase). Se devuelve con el flag 0x8. */
    "avl_hw": <uint>,            /* Tipo de dispositivo. */
    "avl_resource": <uint>,      /* Recurso. */
    "avl_retranslator": <uint>,  /* Repetidor. */
    "avl_unit": <uint>,          /* Unidad. */
    "avl_unit_group": <uint>,    /* Grupo de unidades. */
    "user": <uint>,              /* Usuario. */
    "user_group": <uint>,        /* Grupo de usuarios. */
    "avl_route": <uint>          /* Ruta. */
  },

  "web_site": <text>,               /* URL del sistema de rastreo de Wialon. Se devuelve con el flag 0x40. */
  "web_cms_manager_site": <text>,   /* URL del sistema de gestión de Wialon. Se devuelve con el flag 0x40. */

  "features": {                     /* Se devuelve con el flag 0x10. */
    "unlim": <bool>,  /* Tipo de plan de facturación: 0 (normal) o 1 (especial, para desarrollo y pruebas). */
    "svcs": {         /* Colección hash de servicios permitidos. Si un servicio no se menciona aquí, está prohibido. */
      "<service_name>": <bool>,  /* Clave: nombre del servicio. Valor: 0 (el servicio está disponible, pero se alcanzó el límite) o 1 (el servicio está disponible y se puede utilizar). */
      ...
    }
  },

  "video_service_url": <text>       /* URL del servicio de vídeo (solo si el servicio Videovigilancia está habilitado). */
}

En Wialon Local, los parámetros drivers_feature_flags y feature_flags están disponibles a partir de la versión 2604. Los parámetros billing_by_codes y video_service_url no están disponibles en Wialon Local.

Si la solicitud falla, se devuelve un código de error.

Códigos de error

Código de error Descripción
4 Longitud del token incorrecta.
6 Error desconocido.
7 El usuario está deshabilitado, aún no llegó la hora de activación del token o no hay acceso al servicio.
8 No se encontró el usuario subordinado indicado o usted no tiene derechos de acceso a este usuario.
1003 Se alcanzó el límite de solicitudes.

Si nota un error en el texto, por favor resáltelo y presione Ctrl+Intro.