WebSocket (visão do desenvolvedor)
Uma conexão full-duplex de longa duração. Diferente do HTTP de um-envio-uma-resposta, o WS primeiro estabelece uma conexão, depois envia / recebe quadros a qualquer momento e, por fim, fecha.
Como usar na UI
- Crie uma requisição WebSocket: a URL recebe o endereço completo (
ws://…/ws/echoouwss://…/path); headers de handshake vão para os headers da requisição. - Toque em Conectar para estabelecer a sessão.
- Digite na sessão e envie; os quadros recebidos aparecem em tempo real.
- Feche a sessão ao terminar (sessões têm cota; as ociosas são recuperadas automaticamente).
Texto puro vs. criptografado
ws://é texto puro;wss://usa TLS.- Se você passar pelo Pre-URL WS do ambiente, esse endereço base deve ser escrito como
ws:///wss://—https://seria tratado como HTTP (veja concepts).
Comportamento verificado
Quadros de texto fazem a ida e volta com o UTF-8 intacto (hello-ws-世界 enviado e recebido idêntico). O /ws/headers ecoa de volta os headers que você enviou no handshake, o que facilita verificar que eles tiveram efeito. Subprotocolos, compressão e heartbeats são cobertos nos casos de teste automatizados.
Pontos de atenção
- Nenhum eco recebido: confirme que o servidor realmente responde; 'enviar' em uma conexão longa apenas emite — a resposta chega depois como um quadro recebido.
- Quer apenas observar sem enviar: depois de conectar você pode acompanhar os quadros de entrada (ex.: pushes do servidor).
- A cota de sessão é limitada e sessões ociosas fecham após ~5 minutos; feche sessões antigas prontamente ao depurar em lote.
Relacionado: configuração de UI de conexão/envio em concepts.