Buone pratiche per la progettazione di un'API basata su Websocket

Question

Attualmente stiamo implementando un'API basata su WebSocket nel nostro application.

Finora, offriamo un'API REST, oltre a un'API XMPP e ci aspettiamo di offrire funzionalità simili, ma non siamo sicuri del suo design.

Useremo un formato dati JSON, ma questa è praticamente l'unica cosa che sappiamo per certo. Ci sono buone pratiche su questo?

Ad esempio, l'API REST ha il grande vantaggio di utilizzare i verbi HTTP e le risorse URL per descrivere ciò che viene fatto. Websocket non ha nessuno di questi. Una volta stabilita la connessione, l'URL diventa irrilevante.

Qualcuno sa di API basate su Websocket esistenti?

Answer 1

Sì, c'è: here.

[edit: morti collegamento comunità wiki rimosso]

Answer 2

Qui ci sono un basate paio websocket API/protocolli:

Pusher

Slack Real Time Messaging

Sembra la maggior parte delle persone che sono cliente JS fronte stanno usando qualche tipo di evento/comando in coppia con un oggetto dati. Inoltre, Slack ha l'idea di un messaggio id tale da poter associare messaggi di richiesta e risposta.