Conexión, suscripción y latido
Conexión, suscripción y latido
Conéctate a 6MM WebSocket retransmisiones, suscríbete a temas, mantén vivas las conexiones y procesa los sobres de los mensajes de forma segura.
Utiliza WebSocket flujos para datos de mercado y actualizaciones privadas del estado del usuario que deben mantenerse actualizadas sin necesidad de sondeos.
Conexión URL
Los flujos privados requieren un contexto de autenticación como un listenKey o un token de acceso, tal y como se describe en la documentación del canal privado.
Suscríbete
Reconocimiento de suscripción exitoso:
Cancelar suscripción
Ping de la aplicación
Sobre de mensajes
Los empujes públicos utilizan un límite consistente:
Recomendaciones operativas
- Generar una
idúnica en el lado del cliente para cada solicitud de suscripción, baja y ping. - Tratar la reconexión como una nueva sesión y volver a suscribirse a los temas requeridos.
- Validar que el
topicdevuelto coincida con el canal que espera tu servicio. - Mantener el procesamiento de mensajes idempotente cuando hay eventos privados de orden o cuenta involucrados.
- Cambios en el estado de la conexión de registro, acuses de recibo de suscripción y desconexiones anormales.
Flujo de trabajo de reconexión
- Cierra o descarta el socket anterior y crea una nueva conexión.
- Re-autenticar flujos privados con un listenKey o token de acceso válido.
- Suscribirse de nuevo a todos los temas requeridos y esperar los reconocimientos exitosos.
- Sustituir el estado local del libro de órdenes por una nueva instantánea antes de aplicar actualizaciones incrementales.
- Reconciliar órdenes abiertas, posiciones y saldos a través de REST si se han pasado por alto eventos privados.
Utiliza retroceso exponencial limitado con jitter para los intentos de reconexión. Un cliente que se reconecte continuamente debería alertar a los operadores en lugar de intentarlo indefinidamente sin visibilidad.
Latido cardíaco y conexiones rancio
- Rastrear el mensaje entrante más reciente y el reconocimiento de ping exitoso.
- Utilizar el intervalo de latidos cardíacos y el umbral de reposo aprobados para el entorno de producción.
- Tratar una conexión como obsoleta cuando se supera el umbral configurado, incluso si el zócalo de TCP sigue abierto.
- No reutilizar suscripciones de un socket antiguo; volver a suscribirse explícitamente después de cada reconexión.
Documentación relacionada
- Canales de Mercado Público: temas, continuidad del libro de órdenes, operaciones, velas y tickers.
- Canal de Usuario Privado: listenKey ciclo de vida y eventos autenticados.
- Recomendaciones de Integración: pruebas de intentos, idempotencia, monitorización y lanzamiento.