Puertos y endpoints

Esta página es la referencia de red de CORE-M: qué puerto transporta qué protocolo, las rutas REST canónicas y el WebSocket en tiempo real. Todos los puertos listados son las asignaciones estándar de IANA para su protocolo.

Puertos

Puerto	Protocolo	Superficie	Notas
8080	HTTP	REST API	REST API de la plataforma
1883	MQTT	Ingesta de dispositivos	MQTT a través del broker externo EMQX; un bridge de downlink gestiona el tráfico de servidor a dispositivo. No hay listener MQTTS en proceso.
5684	CoAPS	Ingesta de dispositivos	CoAP sobre DTLS-PSK (UDP). No hay listener de CoAP en texto plano.
5685	LwM2M (DTLS)	Gestión de dispositivos	LwM2M sobre CoAP/DTLS (UDP). No hay LwM2M en texto plano.
161	SNMP	Polling de dispositivos	Solo polling saliente; 161 es el puerto del dispositivo destino. No hay receptor de traps.

Nota

CoAP y LwM2M usan listeners separados: la ingesta CoAP es solo DTLS-PSK en 5684, y LwM2M es solo DTLS en 5685. Ninguno de los dos protocolos expone un listener en texto plano.

Rutas REST clave

La lista completa y siempre actualizada de endpoints es el OpenAPI/Swagger integrado en la aplicación, generado por servicio. La tabla siguiente es el conjunto de rutas core confirmado. Todas las rutas se sirven en el puerto 8080 bajo el prefijo /api/v1 salvo que se indique.

Gateway

Método	Path	Propósito	Auth
GET	/healthz	Liveness	None
GET	/readyz	Readiness	None
POST	/api/v1/callbacks/arc	Callback de confirmación de ARC	HMAC (sin bearer)

Auth

Método	Path	Propósito
POST	/api/v1/auth/login	Autenticar, recibir tokens
POST	/api/v1/auth/refresh	Rotar el par de tokens
POST	/api/v1/auth/validate	Validar un JWT (interno)
POST	/api/v1/auth/api-keys	Crear una API key

Auth también expone rutas de tenant, grupo, SSO, MFA, sesión y tokens con scope — consulta el Swagger de auth y Seguridad y cumplimiento.

Device registry

Método	Path	Propósito
POST	/api/v1/devices	Registrar un dispositivo
GET	/api/v1/devices/{device_id}	Obtener un dispositivo
GET	/api/v1/devices	Listar dispositivos (filtros + paginación)
PATCH	/api/v1/devices/{device_id}	Actualizar un dispositivo
DELETE	/api/v1/devices/{device_id}	Eliminar (soft-delete) un dispositivo

Device link (provisioning, RPC, gateways, atributos, OTA)

Método	Path	Propósito
POST	/api/v1/provision	Hacer provisioning de un dispositivo (flujo key/claim)
POST	/api/v1/devices/{device_id}/rpc	Enviar un RPC de servidor a dispositivo
GET	/api/v1/devices/rpc/{correlation_id}	Obtener un resultado de RPC por correlation ID
POST	/api/v1/gateway/{gateway_device_id}/connect	El gateway conecta un dispositivo hijo
POST	/api/v1/gateway/{gateway_device_id}/telemetry	El gateway envía telemetry de un hijo
POST	/api/v1/gateway/{gateway_device_id}/rpc-response	El gateway devuelve el resultado de un RPC del hijo

Consulta Device RPC para el ciclo de vida del RPC y Conectar dispositivos para las rutas de provisioning.

Telemetry

Método	Path	Propósito
POST	/api/v1/telemetry	Ingerir uno o más puntos
GET	/api/v1/telemetry/{device_id}/latest	Snapshot más reciente (hot store)
GET	/api/v1/telemetry/{device_id}	Consulta histórica (cold store)

Consulta Enviar telemetry para la ingesta y Consulta y retención de telemetry para el modelo de consulta.

Rules

Método	Path	Propósito
POST	/api/v1/rules	Crear una regla
GET	/api/v1/rules/{rule_id}	Obtener una regla
GET	/api/v1/rules	Listar reglas
PATCH	/api/v1/rules/{rule_id}	Actualizar una regla
DELETE	/api/v1/rules/{rule_id}	Eliminar una regla
POST	/api/v1/rules/{rule_id}/enable	Habilitar una regla
POST	/api/v1/rules/{rule_id}/disable	Deshabilitar una regla

Chain anchor

Método	Path	Propósito
GET	/api/v1/anchors	Listar lotes (batch) de anchor recientes
GET	/api/v1/anchors/batches/{batch_id}	Obtener el estado de un lote

Verificación

Método	Path	Propósito	Auth
GET	/api/v1/verify/hash/{data_hash_hex}	Prueba por hash de datos	None (verificable públicamente)
POST	/api/v1/verify/raw	Prueba a partir de campos en crudo	None (verificable públicamente)
GET	/api/v1/verify/batch/{batch_id}	Prueba completa del lote	None (verificable públicamente)

Consulta Verificación para la estructura de la prueba y los pasos de verificación del lado del llamador.

WebSocket

Los datos en tiempo real se entregan mediante el dashboard BFF a través de un WebSocket en /ws. La conexión se autentica con el JWT access token. Los clientes se suscriben a telemetry de dispositivos o a eventos de plataforma y pueden solicitar un breve backfill histórico; el servidor envía telemetry en vivo, cambios de estado de dispositivo, disparos de reglas y confirmaciones de anchor.

wss://<host>/ws?token=<access_token>

Dirección	Tipos de mensaje
Cliente → servidor	subscribe, unsubscribe, backfill
Servidor → cliente	telemetry, device_status, rule_triggered, anchor_confirmed, backfill_response