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
svc=core/use_auth_hash¶ms={
"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:
{
"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. */
...
}
}
}
Para obtener más información sobre
<service_name>, consulte la lista de servicios.
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. |