add docs for the new json format
Merge pull request #3001 from dotcloud/api_json

add docs for the new json format