Buenas prácticas para el diseño de una API basada en Websocket

Question

Actualmente estamos implementando una API basada en WebSocket en nuestro application.

Hasta ahora, ofrecemos una API REST, así como una API XMPP y esperamos ofrecer características similares, pero no estamos seguros del diseño de la misma.

Utilizaremos un formato de datos JSON, pero eso es prácticamente lo único que sabemos con certeza. ¿Hay alguna buena práctica sobre esto?

Por ejemplo, la API REST tiene la gran ventaja de utilizar verbos HTTP y recursos de URL para describir lo que se está haciendo. Websocket no tiene ninguno de estos. Una vez que se establece la conexión, la URL se vuelve irrelevante.

¿Alguien sabe acerca de las API existentes basadas en websocket?

Answer 1

Sí, hay: here.

[editar: enlace de la comunidad wiki muertos eliminado]

Answer 2

Aquí están basados ​​en APIs par WebSocket/protocolos:

Pusher

Slack Real Time Messaging

parece que la mayoría de personas que son clientes JS frente están utilizando algún tipo de evento/comando emparejado con un objeto de datos. Además, Slack tiene la idea de un mensaje id para que pueda asociar los mensajes de solicitud y respuesta.