Aller au contenu principal

WebSocket (vue développeur)

Une connexion longue full-duplex. Contrairement au modèle HTTP « un envoi, une réception », WS établit d'abord une connexion, puis envoie / reçoit des frames à tout moment, et enfin se ferme.

Comment l'utiliser dans l'interface​

  1. Créez une requête WebSocket : l'URL prend l'adresse complète (ws://…/ws/echo ou wss://…/path) ; les headers du handshake vont dans les headers de la requête.
  2. Appuyez sur Connecter pour établir la session.
  3. Tapez dans la session et envoyez ; les frames reçues s'affichent en temps réel.
  4. Fermez la session quand c'est terminé (les sessions ont un quota ; les inactives sont récupérées automatiquement).

En clair ou chiffré​

  • ws:// est en clair ; wss:// utilise TLS.
  • Si vous passez par la Pre-URL WS de l'environnement, cette adresse de base doit s'écrire ws:///wss:// — https:// serait traité comme HTTP (voir concepts).

Comportement vérifié​

Les frames texte font l'aller-retour avec UTF-8 intact (hello-ws-世界 envoyé et reçu à l'identique). /ws/headers renvoie en écho les headers envoyés pendant le handshake, ce qui permet de vérifier facilement qu'ils ont pris effet. Sous-protocoles, compression et heartbeats sont couverts par les cas de test automatisés.

Pièges​

  • Pas d'écho reçu : confirmez que le serveur répond réellement ; « envoyer » sur une connexion longue ne fait qu'émettre — la réponse arrive ensuite comme frame reçue.
  • Vous voulez juste observer sans envoyer : après la connexion vous pouvez regarder les frames entrantes (ex. poussées du serveur).
  • Le quota de sessions est limité et les sessions inactives se ferment après ~5 minutes ; fermez rapidement les anciennes sessions quand vous déboguez en série.

À lire aussi : la configuration de connexion/envoi dans l'interface dans concepts.