ZgPHP Meetup #94
27 Jun 2019 at Undabot d.o.o.

The API design is a topic I find to be interesting and I've learned it is sometimes hard to both development teams producing and consuming the APIs. I will go over ideas and tricks on how to approach designing web APIs, what to think about and what to watch for, as well as share a lot of my experience and troubles I've seen as best as it can be done in short talk. This is also an introduction into more talks and topics I plan to cover in future meetups.

Developing the API from scratch is the most interesting thing one backend developer can imagine IMO. Maintaining and scaling that API for years to come is challenging, kind of repetitive, but still interesting! Maintaining the API docs while doing the previous, however, seems like the most complex task for most of the teams I've met and worked with. Not because it is hard to do, but because it's easy to forget about it and do it wrong, and I'm thinking about how we could make it harder for us? In this talk, I will show to you my approach on verifying if the API documentation is still in sync with the actual API, if your APIs are lying and making life miserable for your client-side fellow developers, how to add all these things to the CI and how to combine everything by using standards and tools you may, or may not, know about.