softwareas.com
API Pattern: Self-documenting REST Responses
Here is an example of a self-documenting REST response. Ideally every API call should let the developer append a param like help=true to get details such as calling context, documentation links, ex…