Whether you offer third party access to your APIs, or you offer them up for internal use, you should take a look at adding some Swagger to your step.The new open source framework comes from Wordnik and the awesome Tony Tam. They have long offered up APIs to their vast data and services with a variety of client side SDKs that work with their REST APIs.