Saltar al contenido principal

WebSocket (visión de desarrollador)

Una conexión de larga duración full-duplex. A diferencia del patrón HTTP de un envío por cada recepción, WS primero establece una conexión, luego envía / recibe frames en cualquier momento y finalmente cierra.

Cómo usarlo en la interfaz​

  1. Crea una solicitud WebSocket: la URL toma la dirección completa (ws://…/ws/echo o wss://…/path); las cabeceras del handshake van en las cabeceras de la solicitud.
  2. Toca Conectar para establecer la sesión.
  3. Escribe en la sesión y envía; los frames recibidos aparecen en tiempo real.
  4. Cierra la sesión al terminar (las sesiones tienen cuota; las inactivas se reclaman automáticamente).

Texto plano vs cifrado​

  • ws:// es texto plano; wss:// usa TLS.
  • Si pasas por la Pre-URL WS del entorno, esa dirección base debe escribirse como ws:///wss:// — https:// se trataría como HTTP (ver conceptos).

Comportamiento verificado​

Los frames de texto hacen la ida y vuelta con UTF-8 intacto (hello-ws-世界 se envía y recibe idéntico). /ws/headers devuelve las cabeceras que enviaste durante el handshake, lo que facilita verificar que surtieron efecto. Subprotocolos, compresión y heartbeats están cubiertos en los casos de prueba automatizados.

Advertencias​

  • Sin eco recibido: confirma que el servidor realmente responde; «enviar» en una conexión larga solo emite — la respuesta llega después como frame recibido.
  • ¿Solo quieres observar sin enviar?: tras conectar puedes ver los frames entrantes (p. ej. push del servidor).
  • La cuota de sesiones es limitada y las sesiones inactivas se cierran tras ~5 minutos; cierra las sesiones antiguas con rapidez al depurar por lotes.

Relacionado: configuración de conexión/envío en la interfaz en conceptos.