Jangle Core - Specification Version 1.0

The Jangle Core is the Atom Publishing Protocol interface to Jangle. It enables clients to access and (eventually) create and modify library resources RESTfully using regular AtomPub libraries (and conventions). The core also serves as the mediator between the client and the connector, receiving incoming requests, brokering them to the appropriate connector, parsing the JSON responses and serializing them into appropriate XML documents (Atom Syndication Format, Atom Services documents, OpenSearch Description documents, etc.).

A Jangle application does not need to follow the core/connector to be compliant, as long as the client interface responds appropriately. To be compliant as a Jangle core, however, it must be able to communicate with at least one connector.

The only HTTP methods covered by this specification are GET and HEAD. Future revisions will define how the other methods are handled.

All Jangle applications must respond with an Atom Services document at base_url/services/ (or be redirected to one) and return the content-type application/atomsvc+xml. This is the only reserved path for Jangle core compliant applications.

Typically, Jangle applications proxy a connector off of a subdirectory off of the base_url.
Example:
http://demo.jangle.org/openbiblio/

Where http://demo.jangle.org/ is the base url and an openbiblio is the path to the connector.