This page is a Work in Progress.

Common wisdom, to consider when building an API.

don't re-invent the wheels. Instead of debating and defining what the json output looks like, use one of these:

1) put it on the CKAN at
2) use 's very well defined format, which also has lots of tooling.