5 ms·
Examples of really good APIs: helpful or no?
Hello smart people!
I'm currently building a visual resource guide to creating and enhancing APIs with common features to improve user adoption and experience. Right now, it is in the form of a blog that is broken down into API related categories, including things like documentation, SDKs, versioning, etc. The format of a single blog post goes something like this: "How company name does use case (e.g. How Stripe does documentation) Each post is highly visual, with several screenshots and a few brief sentences explaining the use case and the value that it provides users.
My question to you all is: what kind of content would you most like to see in terms of API inspiration? If you are someone who builds, modifies, or uses APIs frequently, what would the most useful content look like? Would it be highly visual (screenshots) or highly content oriented (code snippets)? Would you find this product useful at all? Or would you build/modify/use an API the same way regardless of how other companies do theirs?
I am looking for any feedback at all on this idea, even if it's something totally different than the questions that I proposed above. Thank you for your help!
- westonplatter0 8y ago> Would it be highly visual (screenshots) or highly content oriented (code snippets)? Both.
- asherdawson 8y agoGood to know, thanks!
- dmlittle 8y agoCheck out High Scalability's Real Life Architecture section[1], they have similar articles to what you're describing. [1] http://highscalability.com/blog/category/example http://highscalability.com/blog/category/example