open access model to a read-only public HTTP surface.
Both identifiers are URL-decoded by the server, so encode each path component rather than the complete path.
Access behavior
- A missing subpath returns
400 Bad Request. - An unknown node or item returns
404 Not Found. - A node that is not
openreturns403 Forbidden. - Item bodies are returned as XML; the service does not convert arbitrary payloads to JSON.
- The feed orders items by most recent creation time and includes item links, publisher, dates, and stable object GUIDs.
Web nodes
A PubSub node can also drive rendered web content. The/PubSub/ route exposes the source feed/item XML, while a separately configured web-node route can render the information as a site. Keep source payload compatibility and presentation versioning separate.
Consumer rules
- Treat item XML as untrusted input and disable unsafe external entity processing.
- Use item IDs or feed GUIDs for deduplication.
- Poll with cache validators/backoff; do not assume an event stream.
- Follow item links only on the expected Neuron origin.
- Use authenticated XMPP PubSub for non-public data or publishing operations.