Contadores Inteligentes México — Documentación de API

Secciones: 1 · Acceso, sesión y autenticación 2 · Monitoreo en tiempo real 3 · Vehículos y dispositivos 4 · Órdenes / control del equipo 5 · Video en vivo, playback y PTZ 6 · Historial / recorridos 7 · Alarmas en tiempo real y gestión 8 · Configuración y tipos de alarma 9 · Reportes de circulación y pago 10 · Estadísticas de riesgo, conducción y scoring 11 · Geocercas, reglas y regiones 12 · Configuración de plataforma 13 · Administración: usuarios, roles, admins, compañías, SIM, conductores 14 · Operativos: mantenimiento, seguros, anuales, reparaciones, accidentes, rutas, firmware 15 · JT/T 809 y regulatorio 16 · Logs del sistema y exportación

Uso general: todas las respuestas vienen en gzip → usar curl -sk --compressed. Autenticación por header Authorization: Bearer <token> (login en POST /admin/login). Los listados usan paginación pageNum&pageSize en body o query. Todo reporte tiene su variante de exportación /export o /export/async (Excel).

✓ probado = endpoint ejecutado contra la API real en esta instalación. Los demás están extraídos del front end compilado (ruta+uso) y siguen la convención del backend; el método indicado es el que usa el portal (PATCH/PUT no se usan, todo es GET/POST).

· Guía rápida (probado)

Método	Endpoint	Descripción / ejemplo
POST	/admin/login	Login. Body `{"username":"...","password":"..."}` → `data.tokenHead + data.token` = header `Authorization`.
POST	/vehicle/list	Consultar vehículo → vehicleId. Body `{"licenseNum":"<placa>"}` o `{"deviceNum":"<imei>"}`.
POST	/device/control	Paro de motor/aceite. Body `{"vehicleIds":[id],"orderType":"title_2_order_8","command":114}` → 114=cortar motor (OUT2), 115=restablecer, 112/113=aceite (OUT1), 4=reiniciar equipo (orderType `title_2_order_3`).
POST	/device/order/history	`{"pageNum":1,"pageSize":10,"vehicleId":id}` → `orderStatus`: 0 envío falló, 1 respuesta OK, 2 esperando respuesta, 3 respuesta con fallo.

BASE=https://api.247gps.info/vehicle-admin TOKEN=$(curl -sk --compressed -X POST "$BASE/admin/login" -H "Content-Type: application/json" \ -d '{"username":"admin","password":"COLOCA_TU_CLAVE"}' | jq -r '.data.tokenHead + .data.token') # paro de motor OUT2 (114) / restaurar (115) — prueba SOLO en equipo aislado curl -sk --compressed -X POST "$BASE/device/control" -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" -d '{"command":114,"orderType":"title_2_order_8","vehicleIds":[17]}'

1 · Acceso, sesión y autenticación

Método	Endpoint https://api.247gps.info/vehicle-admin	Notas
POST	/admin/login	✓ probado — autenticación. Body {"username","password"} → data.tokenHead + data.token (concatenar = header Authorization)
POST	/admin/mobileLogin	login móvil
POST	/admin/logout	cierre de sesión
GET	/admin/getCode/{id}	código de invitación/recuperación de un admin
GET	/sys/login/getQrCode	QR de login
GET	/user/info	✓ probado — datos del usuario autenticado
POST	/user/update/password	cambio de contraseña del usuario
POST	/sys/menu/sort	orden de menús
GET	/menu/treeUserList	árbol de menús del usuario

2 · Monitoreo en tiempo real (mapa)

Método	Endpoint https://api.247gps.info/vehicle-admin	Notas
ARRAYPOST	/postion/realtime/vehicleGps	✓ probado patrón — posiciones GPS en vivo de una lista de vehicleIds (body = array de ids). El mapa del front llama cada 10 s
GET	/postion/realtime/vehicleGps/{vehicleId}	posiciones de una unidad
GET	/postion/realtime/vehicleStatistics	contadores en vivo (online/total, vehículos autorizados vs. asignados)
GET	/postion/realtime/vehicleAllTreeList	árbol de vehículos (filtrado por el usuario/JWT)
GET	/postion/realtime/attentionList	lista de vehículos en atención/seguimiento
POST	/postion/realtime/vehicleAttention/	agregar vehículo a atención
POST	/postion/realtime/deleteVehicleAttention/	quitar vehículo de atención
POST	/postion/realtime/area/vehicleGps	posiciones por zona de negocio (body con {areaCode\|parentCode, ...})
GET	/postion/realtime/location	envía orden de 'reporte de posición' (roll call) a un equipo; query ?deviceNo=
GET	/postion/realtime/deviceChannels/{deviceId}	canales de video de un equipo
GET	/postion/realtime/closeVehicleGps/{vehicleId}	detiene el seguimiento de una unidad
GET	/vehicle/asyncUpdateMem	refresca el mapa/almacén en memoria de vehículos (Redis)

3 · Vehículos y dispositivos

Método	Endpoint https://api.247gps.info/vehicle-admin	Notas
POST	/vehicle/list	✓ probado — lista/consulta de vehículos. Filtro real por {"licenseNum":""} o {"deviceNum":""}; sin filtro lista todos. Devuelve vehicleId/licenseNum/deviceNum
POST	/vehicle/list?pageNum=&pageSize=	listado paginado completo
GET	/vehicle/list/all	lista completa de vehículos (solo ids)
GET	/vehicle/list/all/{id}
GET	/vehicle/select/{id}	vehículo por id
POST	/vehicle/create	crear vehículo
POST	/vehicle/update/{id}	actualizar vehículo
POST	/vehicle/delete	eliminar vehículos
POST	/vehicle/fastCreate	alta rápida
POST	/vehicle/export	exportar listado (Excel/async)
POST	/vehicle/export/async	exportación asíncrona
POST	/vehicle/password/{id}	contraseña del vehículo
GET	/vehicle/motorcade/treeList/device	árbol 车队/vehículos por dispositivo
POST	/vehicle/motorcade/create	crear 车队 (flotilla/motorcade)
POST	/vehicle/motorcade/update	actualizar flotilla
GET	/vehicle/motorcade/delete/{id}	eliminar flotilla
POST	/device/list	listado de dispositivos (paginado)
GET	/device/list/sim/all	dispositivos/sim disponibles
GET	/device/list/vehicle/all	listado para ASIGNAR a vehículos
GET	/device/get/{id}	detalle de dispositivo
POST	/device/create	crear dispositivo (IMEI)
POST	/device/update/{id}	actualizar dispositivo
POST	/device/export/async	exportar dispositivos
POST	/device/shell	relación dispositivo ↔ vehículo (shell)
GET	/device/attributes/{id}	atributos de un dispositivo
GET	/device/attributes/vehicle/{vehicleId}	atributos por vehículo
GET	/device/deviceInfoVoAttribute/vehicle/{vehicleId}	atributos completos por vehículo
GET	/device/channels/{deviceId}	canales del MDVR
GET	/device/disks/{deviceId}	discos de almacenamiento del MDVR
POST	/device/drive_recorder/data	datos del tacógrafo
POST	/device/find/settings	configurar búsqueda de dispositivo
POST	/device/find/settings/sync	sincronizar configuración de búsqueda
POST	/device/order/offline	registro de órdenes offline
POST	/device/order/offline/export/async	exportar órdenes offline
POST	/device/settings	configuración avanzada del dispositivo

4 · Órdenes / control del equipo (incluye paro de motor)

Método	Endpoint https://api.247gps.info/vehicle-admin	Notas
POST	/device/control	✓ probado — envío de ÓRDENES/instrucciones al equipo. Body {"vehicleIds":[],"orderType":"...","command":,"parameter":""}
POST	/device/control/vehicle	orden con más parámetros por vehículo (VehicleControlParameters)
POST	/device/control/set/password	cambiar contraseña del equipo
POST	/device/control/disk/format	formatear disco del MDVR
POST	/device/terminal/textNew	enviar texto/notificación al display del equipo (body incluye vehicleIds)
POST	/device/terminal/text?uuid=	texto (con uuid)
POST	/device/terminal/events	eventos a terminal
POST	/device/terminal/question	encuesta al equipo
POST	/device/terminal/news	noticias/publicidad al display
POST	/device/terminal/camera	control de cámara
POST	/device/terminal/soundRecord	grabación de audio
POST	/device/terminal/voiceMonitor	monitoreo de voz
POST	/device/order/history	✓ probado — historial de órdenes por vehículo. Body {"pageNum","pageSize","vehicleId"} → filas con orderStatus (0 fallo envío, 1 respuesta OK, 2 esperando respuesta, 3 respuesta con fallo)
POST	/device/order/history/export/async	exportar historial de órdenes
POST	/device/order/delete	borrar órdenes
GET	/other/orderType/list	catálogo de tipos de orden (title_X_order_Y)
GET	/rr/textinfo/result?uuid=	resultado de texto enviado

5 · Video en vivo, playback y PTZ

Método	Endpoint https://api.247gps.info/vehicle-admin	Notas
GET	/vedio/monitor/newRealtimeUrl	URL en vivo por cámara: ?phone=&physicalChannel=&streamType=&mediaType=
GET	/vedio/monitor/realtimeUrl	URL en vivo (versión anterior)
POST	/vedio/monitor/control	control del video en vivo (abrir/cerrar/zoom, capturar, etc.)
ARRAYPOST	/vedio/monitor/batch/control	control en lote de varias cámaras
GET	/vedio/monitor/attentionList	vehículos en atención de video
GET	/vedio/monitor/vehicleAllTreeList	árbol para monitoreo de video
GET	/vedio/monitor/vehicleVedioTreeList?id=	árbol de video de un vehículo
GET	/vedio/close/user	cierra sesiones de video del usuario
GET	/vedio/channel/attr	atributos de canal
POST	/playback/video/control	control de reproducción (Modo 0 play, 3 velocidad: body {deviceId:simNum, playbackMode, playbackSpeed,...})
POST	/playback/video/playV1	reproducir grabación
POST	/playback/video/list	lista de grabaciones
POST	/playback/file/list	archivos de grabación (paginado)
POST	/playback/file/upload	subir archivo
POST	/playback/file/upload/control?fileId=	control de subida
POST	/playback/file/upload/progress	progreso de subida
ARRAYPOST	/playback/file/upload/status	estado de subida
POST	/media/file	archivos multimedia (paginado)
POST	/media/package/download	descarga en lote
POST	/panTilt/revolve	control PTZ (mover cámara)
POST	/panTilt/control	control PTZ avanzado
POST	/recording/plan/addOrUpdate	plan de grabación
POST	/recording/plan/delete	eliminar plan
POST	/recording/plan/pageList	planes (paginado)
POST	/recording/plan/pageListVehicle	vehículos de un plan
POST	/recording/plan/batchAddVehicle	asignar vehículos en lote
POST	/recording/plan/batchDeleteVehicle	desasignar vehículos en lote

6 · Historial / recorridos (locus)

Método	Endpoint https://api.247gps.info/vehicle-admin	Notas
POST	/locus/vehicleGps/list	✓ patrón — recorrido (trayectoria). Body {startTime,endTime,vehicleId,fenceIdList}. Timeout del front 180 s
POST	/locus/vehicleGps/list/export/async	exportar recorrido
POST	/locus/vehicleGps/alarm/list	recorrido + alarmas
POST	/locus/vehicleGps/as/alarm/list	puntos de alarma en el recorrido
POST	/locus/multiVehicleGps/list	trayectorias de varias unidades
POST	/locus/vehicle/list	vehículos con recorrido
POST	/locus/update/location	corrección/inserción de posición manual
POST	/locus/alarm/list	alarmas en el tramo
GET	/postion/locus/vehicleAllTreeList	árbol de unidades para recorrido

7 · Alarmas en tiempo real y gestión

Método	Endpoint https://api.247gps.info/vehicle-admin	Notas
POST	/alarm/realtime/list	lista de alarmas en tiempo real (filtros + paginado implícito)
POST	/alarm/realtime/listByPage?pageNum=&pageSize=	alarmas en tiempo real, paginado explícito
POST	/alarm/realtime/list/record/page	alarmas históricas del día (record)
POST	/alarm/realtime/list/record/export/async	exportar record
POST	/alarm/realtime/list/common/detail	detalle común de alarma
POST	/alarm/realtime/list/common/detail/export/async	exportar detalle
POST	/alarm/realtime/agg	agregado (totales por tipo/estado)
POST	/alarm/realtime/agg/export/async	exportar agregado
POST	/alarm/realtime/list/agg/notProcess	agregado de NO procesadas
POST	/alarm/realtime/solveAlarm	procesar/resolver una alarma
POST	/alarm/realtime/solveAlarm/batch	procesar en lote
POST	/alarm/realtime/solveAlarm/onAlarmManager809	resolver alarma desde el gestor 809
POST	/alarm/realtime/export	exportar lista
POST	/alarm/realtime/export/async	exportar asíncrono
POST	/alarm/realtime/process/export	exportar procesamiento
POST	/alarm/realtime/process/export/async	idem asíncrono
GET	/alarm/realtime/attachment/{id}	adjuntos de la alarma
GET	/alarm/realtime/download/attachment/{id}	descargar adjuntos
GET	/alarm/realtime/download/alarmHandle/{id}	descargar adjuntos de procesamiento
GET	/alarm/realtime/repeatFile/{id}	archivo repetido
GET	/alarm/realtime/vehicleAllTreeList	árbol para filtro de alarmas
GET	/alarm/realtime/list/alarmType	tipos de alarma disponibles
GET	/alarm/preview/today/asAlarm	preview de hoy (conteos por tipo)
GET	/alarm/preview/today/analyze/7	tendencia de 7 días
GET	/alarm/preview/today/analyze/	análisis
GET	/alarmPopUp/setting/getInfoByUser	configuración de popup de alarmas del usuario
POST	/alarmPopUp/setting/createOrUpdate	guardar popup de alarmas

8 · Configuración y tipos de alarma

Método	Endpoint https://api.247gps.info/vehicle-admin	Notas
GET	/alarm/setting/type/list	catálogo de tipos de alarma
GET	/alarm/setting/type/list?alarmType=1	catálogo filtrado por grupo
POST	/alarm/setting/list	configuraciones de alarma
POST	/alarm/setting/create	crear configuración (regla de alarma por unidad)
POST	/alarm/setting/update/{id}	actualizar
POST	/alarm/setting/delete	eliminar
POST	/alarm/setting/save	guardar
GET	/alarm/setting/motorcade/tree/	árbol para asignación
GET	/alarm/setting/motorcade/{id}	flotillas con la regla
GET	/alarm/setting/popup/type/list	tipos popup
GET	/alarm/setting/rule/type/list	tipos de regla
GET	/alarm/setting/file/type/list	tipos de adjunto
GET	/alarm/summary/type/listAlarmTypeHasNum	resumen de tipos con conteo
GET	/alarm/summary/type/list/{id}	detalle de tipo
POST	/alarm/summary/vehicle/info	resumen por vehículo

9 · Reportes de circulación y pago (kilometraje, online, combustible, agua, temperatura, conductores, pasajeros, OBD, etc.)

Método	Endpoint https://api.247gps.info/vehicle-admin	Notas
POST	/mileage/vehicle/report	kilometraje por vehículo ({startTime,endTime,...})
POST	/mileage/company/report	kilometraje por compañía
POST	/mileage/driver/report	kilometraje por conductor
POST	/position/pass/rate/report	tasa de paso de posición
POST	/position/locus/complete/rate/report	tasa de completitud de locación
POST	/position/vehicle/drift/rate/report	tasa de deriva de unidad
POST	/position/vehicle/drift/detail/report	detalle de deriva
POST	/position/history/report	reporte de posición histórica
POST	/online/rate/report	tasa de en línea
POST	/online/rate/summary/report	resumen de online
POST	/online/offline/summary/report	resumen online/offline
POST	/online/offline/detail/report	detalle online/offline
POST	/online/acc/ignition/report	reporte ACC/ignición
POST	/online/acc/ignition/statistics/report	estadísticas ACC/ignición
POST	/oilVolume/statistics/report	estadísticas de nivel de combustible
POST	/oilVolume/mileage/report	combustible vs. kilometraje
POST	/oilVolume/loss/analyze/report	análisis de pérdida de combustible
POST	/oilVolume/loss/common/report	reporte común de pérdida
POST	/oilVolume/details/report	detalle de combustible (paginado)
POST	/waterVolume/summary/report	resumen de volumen de agua
POST	/waterVolume/common/report	volumen de agua común
POST	/waterVolume/details/report	detalle de agua (paginado)
POST	/report/temperature/list	lista de reportes de temperatura
POST	/report/temperature/detailInfo	detalle de temperatura
POST	/report/temperature/alarmStatistics	estadísticas de alarma de temperatura
POST	/driver/login/logout/summary/report	resumen de login/logout de conductor
POST	/driver/login/logout/detail/report	detalle de login/logout
POST	/driver/vehicle/login/logout/summary/report	resumen por vehículo-conductor
POST	/driver/vehicle/login/logout/detail/report	detalle por vehículo-conductor
POST	/driver/id/report	reporte de identificación de conductor (IC/ASM)
POST	/passenger/flow/statistics	estadísticas de flujo de pasajeros
POST	/passenger/flow/detail/page	detalle de flujo (paginado)
POST	/passenger/flow/times/summary	resumen de viajes
POST	/passenger/flow/times/page	viajes paginado
POST	/passenger/flow/vehicle/times/summary	viajes por vehículo
POST	/passenger/flow/line/summary	resumen por línea
POST	/passenger/flow/line/statistics/page	estadísticas por línea (paginado)
POST	/passenger/flow/site/statistics/page	estadísticas por parada
POST	/vehicle/overcrowd/statistics/pageList	estadísticas de sobrecupo
POST	/vehicle/overcrowd/statistics/calculateOvercrowdPercentage	calcular % de sobrecupo
POST	/forward/reverse/status/summary/report	resumen de avance/reversa
POST	/forward/reverse/status/details/report	detalle avance/reversa
POST	/forward/reverse/track/details/report	detalle de trayectoria avance/reversa
POST	/punsh-record/driver/report	reporte de punzadas/registros del conductor
POST	/vehicleData/list/report	datos CAN/vehicleData (paginado)
POST	/obd/list/record/page	registros OBD (paginado)
POST	/order/vehicle/detail	detalle de órdenes por vehículo
POST	/order/carpooling/detail	detalle de carpooling
POST	/forklift/inspectionPage	inspección de montacargas
POST	/*/report/export	PATRÓN: todo reporte tiene variante de exportación: /export, /export/async (Excel)

10 · Estadísticas de riesgo, conducción y scoring

Método	Endpoint https://api.247gps.info/vehicle-admin	Notas
POST	/alarm/statistics/list/vehicle	estadísticas de alarma por vehículo
POST	/alarm/statistics/export/vehicle/async	exportar por vehículo
POST	/alarm/statistics/list/company	estadísticas por compañía
POST	/alarm/statistics/export/company/async	exportar por compañía
POST	/alarm/statistics/risk/overallStatistics	estadística general de riesgo
POST	/alarm/statistics/risk/levelTrend	tendencia por nivel de riesgo
POST	/alarm/statistics/risk/eventType	eventos por tipo
POST	/alarm/statistics/risk/mapDistribution	distribución de riesgo en mapa
POST	/alarm/common/list	lista de alarmas común (multi-filtro startTime/endTime/vehicleId)
POST	/alarm/common/report/export/async	exportar común
POST	/alarm/common/selectDeviceAlarmMonthOrDayStatisticsList	estadísticas mensual/diaria
POST	/alarm/report/list/page	reportes de alarma (paginado)
POST	/alarm/report/export/async	exportar reportes
POST	/alarm/evidence/overview	panorama de evidencia de alarma
POST	/driving/behavior/driver/score	puntuación de conducción por conductor
POST	/driving/behavior/driver/trend	tendencia de conducción por conductor
POST	/driving/behavior/vehicle/score	puntuación por vehículo
POST	/driving/behavior/vehicle/trend	tendencia por vehículo
POST	/driving/behavior/company/score	puntuación por compañía
POST	/driving/behavior/company/trend	tendencia por compañía
POST	/scoring/normal/list	listado de reglas de puntuación
POST	/scoring/normal/create	crear regla
POST	/scoring/normal/update	actualizar
GET	/scoring/normal/delete/{id}	eliminar
POST	/scoring/normal/export	exportar

11 · Geocercas, reglas y regiones (electronic fence)

Método	Endpoint https://api.247gps.info/vehicle-admin	Notas
POST	/fence/listAll	todas las cercas
POST	/fence/list	cercas (paginado)
POST	/fence/list/record?pageNum=	registro de cercas
POST	/fence/region/create	crear cerca geográfica
POST	/fence/region/update/{id}	actualizar cerca
POST	/fence/route/create	crear cerca de ruta
POST	/fence/route/update/{id}	actualizar ruta
POST	/fence/route/divide/{id}	dividir ruta
POST	/fence/vehicleGps/list	posiciones de vehículos respecto a cercas
GET	/fence/vehicleAllTreeList	árbol para asignación
GET	/fence/list/vehicle?fenceId=	vehículos de una cerca
POST	/fence/batch/select	asignación en lote
POST	/fence/batch/order/record	órdenes de asignación en lote
POST	/fence/batch/delete/order	borrado en lote
POST	/fence/export/async	exportar cercas
POST	/fence/export/record/async	exportar registros
POST	/fence/region/order	órdenes de región
GET	/fence/region/param?fenceId=	parámetros de la cerca región
POST	/rule/list?pageNum=	reglas (paginado)
POST	/rule/list/all/vehicle	reglas de todos los vehículos
POST	/rule/create	crear regla
POST	/rule/update/{id}	actualizar
POST	/rule/delete	eliminar
POST	/rule/distribute	distribuir regla
POST	/rule/distribute/rule	distribuir por regla
POST	/rule/distribute/vehicle	distribuir por vehículo
GET	/rule/list/company/...	árboles para ABM de reglas
GET	/rule/type/tree	árbol de tipos de regla
POST	/rule/batch/delete	borrado en lote
POST	/region/list	regiones de negocio
POST	/region/create	crear región
POST	/region/delete	eliminar
POST	/region/export	exportar

12 · Configuración de plataforma (mapas, dict, área, servidores)

Método	Endpoint https://api.247gps.info/vehicle-admin	Notas
GET	/config/get/mapKeySetting	✓ usado — clave de proveedor de mapas (Baidu/Bing)
POST	/config/update/mapKeySetting	actualizar claves de mapa
GET	/config/get/basicSetting	configuración básica de la plataforma
POST	/config/create/basicSetting	guardar básica
GET	/config/get/emailSetting	configuración de email
POST	/config/create/emailSetting	guardar email
GET	/config/get/vehicleNum	límite de vehículos (authorizedDeviceNum)
GET	/config/setting/vehicle/{vehicleId}	config del vehículo
GET	/config/select/adminFunConf	funciones del admin
GET	/config/get/realtimeVideoUrl	URL base de video en vivo
POST	/config/upload/file/ftp	subir archivo por FTP
POST	/platformSettings/config	configuración de plataforma
POST	/platformSettings/query	consultar configuración
POST	/platformSettings/instruction	instrucción de plataforma
POST	/platformSettings/queryInstruction	consultar instrucción
GET	/dict/list/codes	diccionarios de códigos
GET	/dict/tree/code	diccionarios en árbol
GET	/area/province	provincias (México: estados)
GET	/area/city/{code}	municipios de un estado
POST	/sys/server/list	servidores del sistema
POST	/sys/server/create	crear servidor
POST	/sys/server/update	actualizar
POST	/sys/server/delete	eliminar
POST	/sys/server/downloadMonitor	monitor de descargas
POST	/sys/server/server/list	lista de servidores
POST	/sys/server/server/create	crear servidor (detalle)
POST	/sys/server/server/update	actualizar servidor
POST	/sys/server/server/delete	eliminar servidor
GET	/sys/server/diskSetting/{id}	disco del servidor
POST	/app/version/page	versiones de app
POST	/app/version/create	crear versión
POST	/app/version/delete	eliminar
GET	/qrcode/download/info	info QR de descargas
POST	/qrcode/download/saveOrUpdate	guardar QR

13 · Administración: usuarios, roles, admins, compañías, SIM, conductores

Método	Endpoint https://api.247gps.info/vehicle-admin	Notas
POST	/user/list	usuarios de la plataforma (paginado)
POST	/user/list/online?pageNum=	usuarios en línea
POST	/user/create	crear usuario
POST	/user/update/{id}	actualizar
POST	/user/delete	eliminar
POST	/user/export/async	exportar
GET	/user/offline/{id}	desconectar usuario
POST	/user/status	estado del usuario
POST	/user/vehicle/{userId}	ASIGNAR vehículos al usuario (base para tu sistema)
GET	/user/list/vehicle?userId=	vehículos asignados
GET	/user/list/vehicle/authorized?userId=	vehículos autorizados
POST	/user/video/list	perfil de video del usuario
GET	/role/treeList	árbol de roles
POST	/role/create	crear rol
POST	/role/update	actualizar
POST	/role/delete	eliminar
POST	/role/updateUserRole	asignar rol a usuario
POST	/role/allocMenuAndPerm	asignar permisos al rol
GET	/role/treeList/{id}	árbol de permisos del rol
GET	/role/listUser/{roleId}	usuarios del rol
GET	/role/listMenuAndPermission/{id}	menús/permisos del rol
POST	/admin/list	administradores (paginado)
POST	/admin/create	crear admin
POST	/admin/update/{id}	actualizar
POST	/admin/delete	eliminar
POST	/admin/export/async	exportar
POST	/admin/vehicle/{adminId}	asignar vehículos al admin
GET	/admin/list/vehicle?adminId=	vehículos del admin
GET	/admin/list/vehicle/authorized?adminId=	vehículos autorizados al admin
POST	/company/list	compañías (paginado)
GET	/company/treeList	árbol de compañías
POST	/company/create	crear compañía
POST	/company/delete	eliminar
POST	/company/export/async	exportar
GET	/company/device/treeList	árbol de dispositivos de compañía
POST	/sim/list	tarjetas SIM (paginado)
POST	/sim/create	crear SIM
POST	/sim/update/{id}	actualizar
POST	/sim/delete	eliminar
POST	/sim/export/async	exportar
GET	/sim/list/device/all	SIMs para dispositivos
GET	/sim/list/sim/all/{id}	detalle SIM
POST	/driver/list	conductores (paginado)
POST	/driver/create	crear conductor
GET	/driver/get/{id}	detalle
POST	/driver/update/{id}	actualizar
POST	/driver/delete	eliminar
POST	/driver/export/async	exportar
POST	/punsh-driver/list	punzadas de conductor (paginado)
POST	/punsh-driver/add	agregar pagación/registro
POST	/punsh-driver/update	actualizar
POST	/punsh-driver/delete	eliminar
POST	/driving/license/list	licencias de conducir
POST	/driving/license/create	crear
POST	/driving/license/update/{id}	actualizar
POST	/driving/license/delete	eliminar
POST	/driving/license/export/async	exportar
POST	/label/list	etiquetas de vehículos
POST	/label/create	crear etiqueta
POST	/label/update/{id}	actualizar
POST	/label/delete	eliminar
POST	/label/export/async	exportar
POST	/label/upgrade/...	gestión de firmware/upgrade (OTA)

14 · Operativos: mantenimiento, seguros, anuales, reparaciones, accidentes, rutas, firmware

Método	Endpoint https://api.247gps.info/vehicle-admin	Notas
POST	/maintain/list	mantenimientos (paginado)
POST	/maintain/create	crear mantenimiento
POST	/maintain/update/{id}	actualizar
POST	/maintain/delete	eliminar
POST	/maintain/export/async	exportar
POST	/insurance/list	pólizas de seguros (paginado)
POST	/insurance/list/advance	seguros con filtros avanzados
POST	/insurance/create	crear póliza
POST	/insurance/update/{id}	actualizar
POST	/insurance/delete	eliminar
POST	/insurance/export/async	exportar
POST	/annual/list	verificaciones/renovaciones anuales
POST	/annual/list/advance	avanzado
POST	/annual/create	crear
POST	/annual/update/{id}	actualizar
POST	/annual/delete	eliminar
POST	/annual/export/async	exportar
POST	/repair/list	reparaciones
POST	/repair/create	crear
POST	/repair/update/{id}	actualizar
POST	/repair/delete	eliminar
POST	/repair/export/async	exportar
POST	/accident/list	accidentes
POST	/accident/create	crear
POST	/accident/update/{id}	actualizar
POST	/accident/delete	eliminar
POST	/accident/export/async	exportar
POST	/transport/list	registro de transporte
POST	/transport/create	crear
POST	/transport/update/{id}	actualizar
POST	/transport/delete	eliminar
POST	/transport/export/async	exportar
POST	/upgrade/list	firmware/actualizaciones
POST	/upgrade/list/record	registro de upgrades
POST	/upgrade/list/task	tareas de upgrade
POST	/upgrade/list/newest/record	últimas actualizaciones
POST	/upgrade/push	empujar firmware
POST	/upgrade/create	crear upgrade
GET	/upgrade/find/all/{id}	detalle
POST	/upgrade/task/push	empujar tarea
POST	/upgrade/task/fail/push	reintentar tarea fallida
GET	/routeInfo/list	rutas
POST	/routeInfo/page	rutas paginado
POST	/routeInfo/create	crear ruta
POST	/routeInfo/update	actualizar
POST	/routeInfo/delete	eliminar
GET	/routeInfo/vehicleList/{id}	vehículos de la ruta
GET	/postion/otaUpgrade/vehicleAllTreeList	árbol para OTA
GET	/postion/issueInstructions/...	árboles para emisión de instrucciones
POST	/face/issued	emitir caras al equipo
POST/GET	/intelligentLinkage/...	enlace inteligente (intercom, reglas)

15 · JT/T 809 y regulatorio (México: no en uso)

Método	Endpoint https://api.247gps.info/vehicle-admin	Notas
GET	/809/up/list?id=	vehículos subidos por provincia 809
POST	/809/up/page	registros 809 (paginado)
POST	/809/up/bindVehicle?id=	vincular vehículo
POST	/809/up/add	agregar
POST	/809/up/update	actualizar
POST	/809/up/delete	eliminar
POST	/809/up/export	exportar
POST	/809/up/control	control
POST	/809/up/position/resend	reenviar posición
POST	/809/up/registerData	datos de registro
POST	/809/check/page	comprobaciones 809
POST	/809/check/reply	responder comprobación
POST	/809/check/export	exportar
POST	/809/supervision/page	supervisión 809 (paginado)
POST	/809/supervision/reply	responder supervisión
POST	/809/supervision/export	exportar
POST	/jt809Protocol/clientStop	detener enlace 809
POST	/jt809Protocol/clientStopNotify	notificar detención
POST	/regulatory/getLocationList	posición regulatoria

16 · Logs del sistema y exportación

Método	Endpoint https://api.247gps.info/vehicle-admin	Notas
POST	/log/list/operate	log de operaciones (paginado)
POST	/log/operate/export/async	exportar
POST	/log/list/login	log de logins
POST	/log/login/export/async	exportar
POST	/log/list/equipment	log de equipos
POST	/log/equipment/export/async	exportar
POST	/excelExport/page	tareas de exportación Excel
GET	/excelExport/modelNames	modelos disponibles
GET	/config/get/exportCriticalValue	valores críticos de exportación
POST	/file/delete	borrar archivo
POST	/file/ftpDirectoryList	listar directorio FTP
POST	/file/ftpFilePageList	archivos FTP paginado
POST	/file/ftpDownload	descargar del FTP
POST	/file/upload/attachedPhoto	subir foto adjunta
POST	/msg/template/file	plantillas de mensajes
GET	/git/info	info de versión (git)