use_auth_hash

Para iniciar sesión con un hash de autorización, utilice el método core/use_auth_hash. Obtenga el hash con el método core/create_auth_hash e indíquelo en el parámetro authHash. Puede utilizar este método en lugar de core/duplicate.

Endpoint

Copied!
svc=core/use_auth_hash&params={
  "authHash": <text>,
  "operateAs": <text>,
  "appName": <text>,
  "checkService": <text>
}

Parámetros

El parámetro authHash es obligatorio. Los demás parámetros son opcionales.

Parámetro Descripción
authHash Hash de autorización que se puede obtener con el método core/create_auth_hash.
operateAs Nombre del usuario subordinado en cuyo nombre desea iniciar sesión. Debe tener el derecho de acceso Actuar en nombre del usuario a este usuario.
appName Nombre de la aplicación. Se guarda en los registros del servidor.
checkService Nombre del servicio que se debe comprobar en el plan de facturación del usuario. Puede obtener la lista de servicios con el método account/get_account_data (consulte la sección Lista de servicios).

Respuesta

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

Copied!
{
    "eid": <text>,                  /* ID de la sesión. */
    "gis_sid": <text>,              /* ID de la sesión para los servicios GIS. */
    "host": <text>,                 /* Host. */
    "hw_gw_ip": <text>,             /* Dirección IP del servidor al que los dispositivos envían datos. */
    "au": <text>,                   /* Nombre de usuario. */
    "hl": <int>,                    /* Existencia del ID de inicio de sesión. True si el campo está presente (el valor siempre es 1). */
    "tm": <uint>,                   /* Hora actual (UTC). */
    "wsdk_version": <text>,         /* Versión del SDK. */
    "base_url": <text>,
    "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. */
    "token": <text>,                /* Token de la sesión. */
    "th": <text>,                   /* Hash del token. */
    "web_site": <text>,             /* URL del sistema de rastreo de Wialon. */
    "web_cms_manager_site": <text>, /* URL del sistema de gestión de Wialon. */
    "user": {                       /* Usuario en cuyo nombre desea iniciar sesión. */
        "nm": <text>,               /* Nombre. */
        "cls": <uint>,              /* ID de la superclase "user". */
        "id": <long>,               /* ID. */
        "prp": {                    /* Propiedades personalizadas, 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>,     /* Unidades de medida estadounidenses (millas y galones). */
            ...
        },
        "crt": <uint>,              /* ID del creador. */
        "bact": <uint>,             /* ID de la cuenta. */
        "fl": <uint>,               /* Flags del usuario. */
        "hm": <text>,               /* Máscara de hosts. */
        "uacl": <uint>,             /* Acceso del usuario a sí mismo. */
        "mu": <uint>,               /* Sistema de medidas. */
        "ct": <uint>,               /* Fecha de creación del usuario. */
        "ftp": {<text>},            /* Ajustes del servidor FTP. */
        "ld": <uint>,               /* Fecha del inicio de sesión anterior. */
        "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 para las aplicaciones móviles indicadas en el plan de facturación. */
    },
    "classes": {                    /* Superclases disponibles para el usuario actual (clave: nombre de la superclase, valor: ID de la superclase): */
        "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. */
        "avl_route": <uint>         /* Ruta. */
    },
    "features": {
        "unlim": <bool>,            /* Tipo de plan de facturación: 0: regular, 1: especial (para desarrollo/pruebas). */
        "svcs": {                   /* Colección hash de los servicios permitidos; si un servicio no se menciona aquí, está prohibido. */
            "<service_name>": <bool>, /* Clave: nombre del servicio; valor: 0: servicio disponible, pero se alcanzó el límite, 1: servicio disponible y se puede utilizar. */
            ...
        }
    }
}

Los flags del usuario se describen en la página update_user_flags.

Para obtener más información sobre los ajustes de FTP, consulte la página update_ftp_property.

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.
6 Error interno del servidor.
7 Acceso denegado.
8 Error al iniciar sesión.
1003 Consulte los detalles en el campo reason.

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