Conexión, Suscripción y Latido
Conexión, Suscripción y Latido
Conéctate a 6MM WebSocket streams, suscríbete a temas, mantén vivas las conexiones y procesa los sobres de mensajes de manera segura.
Usa 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 contexto de autenticación como un listenKey o token de acceso, como se describe en la documentación del canal privado.
Suscríbete
Reconocimiento de suscripción exitoso:
Darse de baja
Ping de aplicación
Sobre de mensaje
Los impulsos públicos usan un sobre consistente:
Recomendaciones operativas
- Generar un
idúnico del lado del cliente para cada solicitud de suscripción, cancelación 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 se involucran eventos privados de orden o cuenta.
- Cambios en el estado de la conexión, acuses de recibo de suscripción y desconexiones anormales.
Flujo de trabajo de reconexión
- Cierra o desecha el socket anterior y crea una nueva conexión.
- Re-autenticar flujos privados con un listenKey o token de acceso válido.
- Volver a suscribirse a todos los temas requeridos y esperar los reconocimientos exitosos.
- Reemplazar el estado local del libro de órdenes con una nueva instantánea antes de aplicar actualizaciones incrementales.
- Reconciliar órdenes abiertas, posiciones y saldos mediante REST si se hayan pasado por alto eventos privados.
Usa retroceso exponencial limitado con jitter para intentos de reconexión. Un cliente que se reconecta continuamente debería alertar a los operadores en lugar de intentar indefinidamente sin visibilidad.
Latidos y conexiones ranciadas
- Rastrear el mensaje entrante más reciente y el reconocimiento de ping exitoso.
- Usar 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 apareciendo abierto.
- No reutilizar suscripciones de un socket antiguo; Suscribe de nuevo 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: intentos, idempotencia, monitoreo y pruebas de lanzamiento.