Re:Clever (YC S12) Lands $3M, Now In 2000 Schools
by christiangenco on Tuesday October 23, 2012 @02:17AM
(#4686864)
I'd like to take a moment to point out how fantastically awesome Clever's API documentation[1] is.
Everyone with an API take note: examples in your favorite language of each API request with a demo API key already set up is how you get developers playing with your API. There was almost zero barrier to entry for me to get data from their API into a language I knew how to manipulate JSON objects with and muck around to my heart's content.
Note to Clever: perhaps go all the way to converting the response body to a JSON object in each language?
Edit: also, the "show/hide, collapse, expand" buttons are confusing. You only need two buttons that change their action depending on the current state ("collapse" becomes "expand" if the content is collapsed), and "show/hide" should be up by the `h2`s.
Everyone with an API take note: examples in your favorite language of each API request with a demo API key already set up is how you get developers playing with your API. There was almost zero barrier to entry for me to get data from their API into a language I knew how to manipulate JSON objects with and muck around to my heart's content.
Note to Clever: perhaps go all the way to converting the response body to a JSON object in each language?
Edit: also, the "show/hide, collapse, expand" buttons are confusing. You only need two buttons that change their action depending on the current state ("collapse" becomes "expand" if the content is collapsed), and "show/hide" should be up by the `h2`s.
1. https://getclever.com/developers/docs