Apis de carga de servicios en Swagger

13 min

antes de empezar es importante desinstalar la versión anterior de la app evidence e instalar la nueva versión para descargar el aplicativo evidence http //e ubiqo net http //e ubiqo net en éste manual se ejemplifica la visualización real de las api en la plataforma ubiqo y sus respectivas relaciones todos los métodos incluyen basic authentication autenticación bearer habilitar autorización presione el botón “authorize” ubicado en la parte superior derecha ingresar token a continuación ingrese el valor conforme a la siguiente estructura, colocando la palabra ‘bearer’ + espacio + token (el token es proporcionado por ubiqo) bearer tokenubiqo asignar servicios \post \ \/v1/asignaservicios\ crea y asigna servicios a cuentas de plataforma ubiqo y/o directamente a dispositivos evidence en especifico a continuación se muestra la estructura del json que se deberá llenar de acuerdo a cada tipo de valor solicitado recuerde que la ruta se estará generando tomando como punto de inicio el 1er servicio y como punto final el último servicio, el resto de servicios se ordenarán en base a la ruta más optima ejemplo de descripción del json asignar servicios a continuación se muestra un ejemplo de la equivalencia de los datos visualizados en la plataforma de ubiqo { "titulo" "actividad 1", "descripcion" "visita a cliente", "direccion" "prol bernardo quintana 28, alamos 2da secc, 76160 santiago de querétaro, qro méxico", "latitud" 20 6065641, "longitud" 100 3810742, "idinterno" "10001", "idformularios" \[ 1824 ], "usuarioadministra" "supervisor", "tags" \[ "sur" ], \ \>\ cuenta a la que se asignarán las actividades "idperfilcargavaloresdefault" 0, "aliasmovil" "evidence 01", "referencias" "casa blanca" } \ \> \ dispositivo evidence al que se le asignará la actividad respuestas al ejecutar el proceso asignar servicios al ejecutar la asignación arrojará como respuesta cualquiera de los siguientes escenarios código 500 ocurrió un error durante el procesamiento, verifique que la estructura de la información sea la correcta código 200 se crearon y asignaron con éxito los servicios enviados estatus de carga de servicios \get \ /v1/consultaestadocarga/{keycarga} permite conocer el estatus de carga de los servicios enviados, por medio de una llave de carga eliminar todas las actividades asignadas sin iniciar \limpieza de actividades\ \post \ \/v1/eliminartodasasignadassininiciar\ elimina todas las actividades asignadas a todos los dispositivos del cliente que aún no hayan sido iniciadas es una llamada directa no requiere parámetros en el cuerpo de la solicitud estatus que se eliminan asignados pendientes de capturar en dispositivo parámetros \nombre\ \tipo\ \requerido\ \descripción\ no esta api no recibe parámetros actúa sobre todas las actividades sin iniciar del cliente autenticado eliminar actividades sin iniciar por dispositivo \limpieza de actividades\ \post \ \/v1/eliminaasignadassininiciarpordispositivo\ elimina únicamente las actividades sin iniciar que estén asignadas a los dispositivos que se especifiquen en la solicitud el resto de los dispositivos no se ven afectados parámetros \nombre\ \tipo\ \requerido\ \descripción\ \\[ \ \100, \ \101, \ \1\ \02, \ \]\ iddispositivo array de strings si lista de ids de los dispositivos son los identificadores únicos generados por la plataforma ubiqo eliminar actividades sin iniciar por lista de actividades \limpieza de actividades\ \post \ \/v1/eliminaasignadassininiciar\ elimina actividades asignadas sin iniciar por id interno del cliente parámetros \nombre\ \tipo\ \requerido\ \descripción\ \\[ \ \“xxx002”, “xxx003”, “xxx004”,\ \ \ \]\ idinterno array de strings si id interno definido por el cliente para esa actividad advertencia crítica pérdida de datos en modo offline \limpieza de actividades\ antes de ejecutar cualquiera de las tres apis anteriores, considera lo siguiente si una actividad fue iniciada o finalizada mientras el dispositivo no tenía conexión a internet, ejecutar cualquiera de estas apis puede provocar la pérdida de esa información mientras los cambios no se sincronicen, la plataforma mostrará la actividad con el estado "sin iniciar", aunque el usuario ya la haya comenzado o concluido desde el dispositivo para evitar la pérdida de información espera a que el dispositivo recupere la conexión para que las actividades se sincronicen y actualicen su estado a "en proceso", "enviando" o el que corresponda si es posible, inicia las actividades únicamente cuando el dispositivo tenga conexión a internet una vez que las actividades estén sincronizadas, podrás ejecutar estas apis sin afectar la información registrada