rest/json

RESTful JSON

Charter

[Initial Draft by Dr. Ernie 12:55, 2 Sep 2008 (PDT)]

Given that:

• REST is a powerful architecture for scalable web services
• JSON is a lightweight container for exchanging data
• AtomPub, while RESTful, requires XML documents with strict metadata requirements

The goal of the RESTful JSON project is to develop a series of conventions for:

• URLs
• HTTP methods
• HTTP headers
• JSON fields

that:

1. is maximally compatible with existing (RESTful, generic) clients
2. enables partial updates
3. allows paging and/or partial returns of large datasets
4. standardizes linking to related resources
5. use of hypermedia (links + context) to manage application state
6. does NOT become a full-fledged RPC solution

Resources

• Original proposal
• Google Group
• [AtomPub] (for comparison/inspiration)

Proposals

• rest/urls
• rest/json-collections
• JSON Referencing

Implementations

• Jester
• Dojo REST store
• DOM Resource
• SproutCore