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 en texto plano
8883	MQTTS	Ingesta de dispositivos	MQTT sobre TLS
5683	CoAP	Ingesta de dispositivos	CoAP en texto plano (UDP)
5684	CoAPS	Ingesta de dispositivos	CoAP sobre DTLS (UDP)
5683	LwM2M	Gestión de dispositivos	LwM2M sobre CoAP (UDP)
5684	LwM2M (DTLS)	Gestión de dispositivos	LwM2M sobre CoAP/DTLS (UDP)
161	SNMP	Polling de dispositivos	SNMP poll (UDP)
162	SNMP trap	Polling de dispositivos	Receptor de SNMP trap (UDP)

Nota

CoAP y LwM2M comparten los puertos CoAP estándar (5683 texto plano, 5684 DTLS): LwM2M se monta sobre CoAP. Que un datagrama se trate como telemetry CoAP en crudo o como una operación LwM2M lo determina el adaptador, no un puerto separado.

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	Required (scope de tenant)
GET	/api/v1/verify/batch/{batch_id}	Prueba completa del lote	Required (scope de tenant)

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