Automatización de la creación y configuración de aplicaciones con REST
Reduzca el tiempo de administración para la configuración de nuevos clientes utilizando REST para crear aplicaciones y crear/agregar usuarios a las aplicaciones.
¿Es nuevo en REST? Comience echando un vistazo a esta guía introductoria de REST para obtener eventos y familiarícese con las API REST.
Configuración/Trabajo previo
1. Agregue el/los tipo(s) de usuario que desea usar en sus nuevas aplicaciones.
2. Configure la(s) plantilla(s) de aplicación.
(NOTA: para rastreadores, el plugin de rastreador apropiado debe estar instalado y el tipo de dispositivo debe especificarse en el tipo de usuario)
Uso de REST para la creación y configuración automatizada de aplicaciones
Crear aplicación y agregar usuario administrador
1. Llame a GET /applicationtemplates para encontrar la plantilla de aplicación que usará.
2. (opcional) Llame a GET /applications/{applicationid:int}/users para encontrar el parámetro AdminID (si desea agregar un usuario administrador cuando cree su aplicación).
3. Llame a POST /applications para crear la nueva aplicación a partir de la plantilla que acaba de encontrar. Los parámetros requeridos en el JSON son applicationTemplateId y name. El parámetro adminUserId es opcional.
¡Ahora debería tener su nueva aplicación!
Encuentre los IDs de tipo de usuario y tipo de dispositivo para sus nuevas aplicaciones
1. Llame a GET /applications/{applicationid:int}/usertypes para encontrar los IDs de usuario para los tipos de usuario operador y dispositivo en su nueva aplicación.
2. Llame a GET /applications/{applicationid:int}/devicetypes para encontrar los IDs de tipo de dispositivo que agregará a sus nuevos usuarios.
Crear operador(es) y activo(s) de dispositivo
1. Llame a POST /applications/{applicationid:int}/users para agregar el usuario operador.
2. Llame a POST /applications/{applicationid:int}/users para agregar el usuario de dispositivo.
Agregar una lista de usuarios a roles
1. Llame a GET /applications/{applicationid:int}/users para devolver una lista de usuarios.
2. Llame a GET /applications/{applicationid:int}/roles para obtener una lista de roles
3. Llame a POST /batch/applications/{applicationid:int}/roles/{roleid:int}/users para agregar los usuarios a los roles especificados.
Agregar una lista de usuarios a múltiples aplicaciones
¡Con estos recursos, puede agregar usuarios existentes a múltiples aplicaciones!
1. Llame a GET /applications para devolver una lista de aplicaciones.
2. Llame a GET /applications/{applicationid:int}/users para obtener la lista de usuarios de una aplicación específica.
3. Llame a PATCH /batch/applications/{applicationid:int}/users para agregar usuarios existentes a una aplicación
¡Felicidades! Su nueva aplicación ahora está lista en su servidor con el/los usuario(s) administrador, operador y dispositivo que creó.
Nota: Si desea realizar los pasos manualmente una vez antes de implementar su integración, puede usar la página de prueba alojada en su servidor (http://YOUR_SERVER_ADDRESS/comGpsGate/api/v.1/test).