[superfreek]

http://open-rpc.org/ is another OpenAPI-like specification for JSON-RPC based architectures.

JSON-RPC is simple, transport agnostic, can support any transport like Websockets, HTTP, even PostMessage.