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).| 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. |
| 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 |
| 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) |
| Método | Endpoint https://api.247gps.info/vehicle-admin | Notas |
|---|---|---|
| POST | /vehicle/list | ✓ probado — lista/consulta de vehículos. Filtro real por {"licenseNum":" |
| 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 |
| Método | Endpoint https://api.247gps.info/vehicle-admin | Notas |
|---|---|---|
| POST | /device/control | ✓ probado — envío de ÓRDENES/instrucciones al equipo. Body {"vehicleIds":[ |
| 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 | ✓ probado — TOMAR FOTO (拍照, tipo 1). Body {"vehicleIds":[ |
| 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 |
vehicleId. Probado en esta instalación contra la API real (unidad de prueba aislada 17 y unidad 9): respuestas {"code":200,"data":N} y orderStatus:1 (应答成功) en el historial. La trama real es JT808 0x8105.POST /device/control · body {"vehicleIds":[<id>],"orderType":"…","command":<n>} (con parameter:"" si aplica).112 = cortar · 113 = RESTAURAR (quitar el paro) — orderType:"title_2_order_8".114 = cortar · 115 = RESTAURAR (quitar el paro) — orderType:"title_2_order_8".4 (reiniciar el MDVR/terminal) — orderType:"title_2_order_3".115 · aceite: 113.vehicleId de POST /vehicle/list con {"licenseNum":"<placa>"} o {"deviceNum":"<imei>"} (unidad 9 = 202508280004).POST /device/order/history con {"vehicleId":<id>} → orderStatus: 0 envío falló · 1 respuesta OK · 2 esperando respuesta · 3 respuesta con fallo./device/order/history que el restablecimiento (115/113) haya sido respondido antes de dar el vehículo por operativo.| Método | Endpoint https://api.247gps.info/vehicle-admin | Notas |
|---|---|---|
| GET | /vedio/monitor/newRealtimeUrl | URL en vivo por cámara: ?phone= |
| 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 |
| Método | Endpoint https://api.247gps.info/vehicle-admin | Notas |
|---|---|---|
| POST | /device/media/search | ✓ probado — 存储多媒体数据检索: pide al EQUIPO que liste lo que tiene guardado en su disco. Body {"vehicleIds":[ |
| POST | /device/media/upload | ✓ probado (aceptada y confirmada por el equipo con 0001) — 单条存储多媒体上传: pide subir UNA foto por su id. Body {"orderType":"title_4_order_7","vehicleIds":[ |
| POST | /device/media/batchUpload | — 存储多媒体数据上传 en lote por criterios (type/channelId/event/startTime/endTime/delete). En esta instalación responde CODE_1895 con criterios que no tienen coincidencias (el lote sube lo que ya reportó la búsqueda). Usar /device/media/upload para un solo archivo conocido. |
| POST | /media/file | ✓ probado — archivos multimedia YA SUBIDOS a la plataforma (paginado). Body {"pageNum","pageSize"}; filtros habituales: vehicleId, mediaType (0 imagen/1 audio/2 video), startTime/endTime, channelId. En esta instalación está VACÍO (total 0): ningún equipo ha conseguido subir multimedia (ver nota del flujo). |
| POST | /media/package/download | descarga en lote de multimedia |
| POST | /playback/file/list | archivos de respaldo (video) paginado |
| POST | /playback/file/upload | subir archivo de grabación al equipo |
| 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 | /file/ftpDirectoryList | directorio FTP del servidor de archivos (contenedor jt808file) |
| POST | /file/ftpFilePageList | archivos FTP paginado |
| POST | /file/ftpDownload | descargar archivo del FTP |
/mnt/contadores-platform/camara_snapshot.sh <phone|imei> <canal> [timeout_seg]/mnt/contadores-platform/camara_snapshot.sh 202508280004 3 # unidad 202508280004, CH3 /mnt/contadores-platform/camara_snapshot.sh 202508280004 4 20 # mismo equipo, CH4, timeout 20 sResultado: guarda
/mnt/contadores-platform/web/camaras/foto_<phone>_ch<canal>_<fecha>.jpg e imprime la URL pública https://mis.contadoresinteligentesmexico.info/camaras/…jpg.GET /vedio/monitor/newRealtimeUrl?phone=<phone>&physicalChannel=<canal>&streamType=0&mediaType=0 → devuelve el flujo en vivo de ZLM, p.ej. https://video.247gps.info:20211/main/00000000202508280004_0003.live.flv.curl -sk "https://127.0.0.1:20211/index/api/getSnap?url=<flv>&timeout_sec=30&expire_sec=0&secret=Richmor2024" -o foto.jpg → ZLM abre el canal y devuelve el JPEG (1280x720). El archivo también queda en el disco del contenedor ZLM (./www/snap/…).web/camaras/ para publicarlo por nginx (o docker cp si se prefiere el jpg original de ZLM).<phone> es el número/IMEI del vehículo que aparece en la lista del portal (para la unidad 9 = 202508280004); el <canal> es CH1…CH6 del bus (portal → cámara). Parámetros configurables al inicio del script: API_USER / API_PASS (login de la plataforma, admin por defecto), ZLM (https://127.0.0.1:20211 o http://127.0.0.1:20201) y SECRET=Richmor2024; la salida y la URL base se cambian con OUTDIR y PUBBASE./device/terminal/camera (JT808 0x8801 → ACK 0x0805), /device/media/search (0x8802 → 0x0802 devuelve la lista; en la prueba id=1, canal 3) y /device/media/upload (0x8805 → ACK 0x0001) SÍ funcionan, pero ningún equipo ha enviado 0x0805 多媒体数据上传 a este servidor (logs: 0 históricos; el almacén /media/file y el FTP quedan vacíos). Los archivos que eventualmente suban (0x0805/descargas) caen en el disco del contenedor jt808file = host /data/vsftpd/data/admin/jtfile/… (FTP user upload/123456A, puerto 20072, pasivo 20100-20130; file-exchange 20022); listado por POST /media/file (filePath) y lectura por /media/package/download/file/ftpDownload o publicando el filePath por nginx.| 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 |
| 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 |
| 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 |
| 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) |
| 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 |
| 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 |
| 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 |
| 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) |
| 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) |
| 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 |
| 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) |
| Método | Endpoint https://api.247gps.info/vehicle-admin | Notas |
|---|---|---|
| POST | /vehicle/list | consultar vehículos / contar los dados de alta — para conocer el margen respecto al límite de dispositivos autorizados |
authorizedDeviceNum (default 200) en la línea 142 de application.yml del servicio vehicle-admin. El contenedor monta esa carpeta del host en /conf, así que basta editar el archivo del host y reiniciar el contenedor. Si se llega al tope, la plataforma no permite dar de alta más dispositivos/vehículos.200 tras reinstalarse la carpeta de la aplicación — SIEMPRE verificar el valor tras una actualización). Alta: 12 vehículos.backups_2026-08-24/…bak-<fecha>_autDevNum; ② confirma el valor con grep y edita SOLO la línea 142 (con edición exacta, sin tocar el resto del YAML); ③ reinicia con docker restart vehicle-admin; ④ espera a que el contenedor quede healthy e interpreta los 503/500 iniciales como warm-up (no como fallo); ⑤ hace login por API hasta ver code=200 y verifica /vehicle/list responde; ⑥ documenta el cambio en REGISTRO_CAMBIOS.md con el valor aplicado y la advertencia de que puede revertirse si se reinstala la carpeta de la aplicación.isMemoryMode: true (línea 143) NO limita dispositivos (solo el árbol de vehículos en memoria). El licenciamiento del fabricante puede imponer un tope adicional por encima de este número. El reinicio de vehicle-admin es breve y no afecta a los demás servicios (aceptación de equipos jt808message:20020, ZLM, FTP, etc.)./root/actualizacionDeEquipos.sh (cómo usarlo y cómo recrearlo si se borra → bloque al final de esta sección).authorizedDeviceNum → docker restart vehicle-admin → esperar "healthy" → verificar login code=200 → mostrar /vehicle/list).