Discover and read the best of Twitter Threads about #APIDesign

Most recents (2)

Even though I haven't been a big fan of Twitter threads so far, a lot of people I know have made 100-tweet threads for @threadapalooza so I thought I'll give it a try as well. I will start with #APIs and hopefully end up connecting them with the #FutureOfWork. Let's go ...

🧵⬇️
First of all, when I talk about #APIs, I mean HTTP-based interfaces connecting apps and backend servers as well as different services with each other. For now, the technical details, such as whether they use REST, GraphQL, gRPC etc., shall not matter. (1/100)
When humans interact with computers they require a user interface (UI), and when machines interact with each other they need application programming interfaces (APIs). At the end of the day, however, these have to be implemented by humans. Good #APIDesign considers both. (2/100)
Read 101 tweets
In ye olden days you needed to write API descriptions by hand, in text, with a keyboard, which took FOREVER.

These days there are awesome GUI Editors, and an interesting new generation of OpenAPI-aware frameworks are appearing, like annotations but good. dev.to/philsturgeon/t…
This cover image, which has been cropped funny and wont be removed, is a visual depiction of how useful Annotation/Comment-based tools usually are.

I got a mention in @libel_vox's awesome tinyletter.com/NetAPINotes/ for this.

tl:dr; Do not confuse proximity with accuracy
The only disagreements I've had with this article were "Um, well achtually, you don't have to write it ALL by hand, you can copy and paste some stuff to speed you up!"

Ooof. I mean, you CAN, but using $ref to split things up is way more useful. stoplight.io/blog/keeping-o…
Read 4 tweets

Related hashtags

Did Thread Reader help you today?

Support us! We are indie developers!


This site is made by just two indie developers on a laptop doing marketing, support and development! Read more about the story.

Become a Premium Member ($3.00/month or $30.00/year) and get exclusive features!

Become Premium

Too expensive? Make a small donation by buying us coffee ($5) or help with server cost ($10)

Donate via Paypal Become our Patreon

Thank you for your support!