About this talk
In this talk, Rustam Mehmandarov from Miles critically examines assumptions surrounding REST APIs and presents effective patterns for building robust and maintainable APIs within real-world systems. Recorded at Open Community Experience 2026 in Brussels, the session delves into the disparities between theoretical REST principles and their practical implementations, highlighting common pitfalls such as improper use of HTTP status codes and inconsistent error responses that complicate integrations. The speaker discusses essential design patterns, including clear endpoint structures, trustworthy HTTP verbs, consistent content negotiation, and emphasizes the importance of API documentation using annotation-driven approaches like OpenAPI. Additionally, the session covers security considerations, effective API versioning strategies, and advanced patterns for handling pagination, filtering, and asynchronous processing, ultimately guiding teams towards the creation of scalable and reliable API systems.
