This slide deck discusses some essential guiding principles regarding good API design, i.e., creating a successful API. It starts with a little counter-example that probably looks just too familiar for many of us.
After that, first I discuss the problems of the counter-example, especially how it feels to the users - the developers who use the API - in terms of DX (developer experience - UX for APIs). Then, I look back into some seminal computer science papers to understand what we can learn from them regarding today's API design.
In the next part, I apply the principles just learnt before to the case study from the beginning. The key of that part is to illustrate the train of thought and guiding principles while designing the API. The details of the resulting API can be discussed of course. If the same train of thought would lead you to a bit different API in your individual context, that's perfectly fine ... ;)
Finally, I added a few complementing thoughts to complete the picture. As always, the voice track is missing which contains a big part of the content. Sorry about that! But I hope that the slides as they are still provide some value for you.