APIs your consumers will love
When designing an API, which properties do we want the resulting API to have? A well-designed API is simple, clean, clear and approachable for its consumers. Why? Because in general, API consumers prefer APIs with these characteristics. And this is
I am excited to show you how to generate Java code for an API based on a Swagger API description. We will use Swaggerhub, which is what I call an integrated design environment for APIs. You have all the tools
In this blog, we study several API styles: the REST-style (Representational State Transfer), the REST-like style, GraphQL, Falcor, the RPC style (Remote Procedure Call), the SOAP style and gRPC. We compare the approaches, show advantages and disadvantages, commonalities and differences.
API description languages are domain-specific languages, which are especially suited for describing APIs. They are both human-readable and machine-readable languages, much like programming languages. They are intuitive languages that can be easily written, read and understood by API developers, API
Whenever APIs need to be communicated among various stakeholders, APIs needs to be described in some from. Thus, it should be as easy as possible to describe APIs. Specialized languages can support the crafting of useful API descriptions by providing