| NATS Client Library |
| ------------------- |
| |
| NATS is a text-based IoT protocol based on a publisher-subscriber paradigm. |
| |
| This implementation is still WORK IN PROGRESS. So, API may change. |
| |
| NATS messages are listed below: |
| |
| Msg Side Description |
| INFO Server Sent to client after initial TCP/IP connection |
| CONNECT Client Sent to server to specify connection information |
| PUB Client Publish a message to a subject, with optional reply subject |
| SUB Client Subscribe to a subject (or subject wildcard) |
| UNSUB Client Unsubscribe (or auto-unsubscribe) from subject |
| MSG Server Delivers a message payload to a subscriber |
| PING Both PING keep-alive message |
| PONG Both PONG keep-alive response |
| +OK Server Acknowledges well-formed protocol message in verbose mode |
| -ERR Server Indicates a protocol error. Will cause client disconnect. |
| |
| |
| Known Limitations |
| ----------------- |
| |
| Msg Side Status |
| INFO Server Partially implemented. Not fully tested. |
| INFO Client Partially implemented. See nats_unpack_info function. |
| CONNECT Client Fully implemented. |
| PUB Client Fully implemented. |
| SUB Client Fully implemented. |
| UNSUB Client Fully implemented. |
| MSG Client Fully implemented. |
| PING Server Fully implemented. |
| PING Client Fully implemented. |
| PONG Server Fully implemented. |
| PONG Client Fully implemented. |
| +OK Client Fully implemented. |
| -ERR Client Not implemented: if the client receives something different |
| from +OK, we must assume an error was detected by the peer. |
| Future versions may include this message. |
| |
| |
| References |
| ---------- |
| |
| More information about the NATS protocol can be found at: |
| |
| http://nats.io/documentation/internals/nats-protocol/ |
