Every story and comment from the Hacker News API, in a layout borrowed from 2001.
A comment on Ask HN: What REST APIs, in your opinion, deserve an award?.
1. Github. WHY: They keep is consistent across versions and it is easy to work with.
2. Hubspot. WHY: Each object is it's own endpoint, very clear and concise. Short on mixed objects that should obviously be easily connected.
3. Mailchimp. WHY: The actual work that gets done with the API is complex while the API itself is not.
Good APIs should be clear, work as stated in the docs, there should never be a case where "logically it should work this way" but it does not.
1. Github. WHY: They keep is consistent across versions and it is easy to work with.
2. Hubspot. WHY: Each object is it's own endpoint, very clear and concise. Short on mixed objects that should obviously be easily connected.
3. Mailchimp. WHY: The actual work that gets done with the API is complex while the API itself is not.
Good APIs should be clear, work as stated in the docs, there should never be a case where "logically it should work this way" but it does not.