rest/json

From Microformats Wiki
Revision as of 19:55, 2 September 2008 by DrErnie (talk | contribs) (marked as draft)
Jump to navigation Jump to search

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

Proposals

Implementations