We are designing an API for one of our products and would love to learn from the best. As a developer, what's the best (any why) Web based API you ever used?
I liked ones that I used and had Swagger documentation, that way you can easily make API calls in the API's documentation.
Take for example pipedrive: <a href="https://developers.pipedrive.com/v1" rel="nofollow">https://developers.pipedrive.com/v1</a>
Whatever web API I use I like it to be documented in automatic way so that is always up to date. Especially in first phase API changes, and I remember bad days spent in discovering the new version of some Facebook api before they get published..sort of MSDN black box hell