Posts Tagged: API design

Do API Standards Differ From Industry to Industry?

At first glance, it would seem that the API space has embraced unified design standards. RESTful development uses HTTP to communicate between a client and a server. OpenAPI Spec serves to extend REST APIs, improving documentation and making APIs machine-friendly.

However, with just a little digging, it becomes apparent that this isn’t always the case. Read more

Auto-Generating a CLI From OpenAPI Specification

As we’ve described many times before, the OpenAPI Specification is a powerful solution for API agility and extensibility. Overseen by the OpenAPI Initiative, the specification drives many modern implementations to new heights. Such is the case with today’s topic, the OpenAPI CLI Generator. Read more

How to Tackle API-First Redesigns for Legacy Applications

Big organizations are slow to change, especially when it comes to technology. After all, the stakes are high, and the complexity of existing systems is even higher. There comes a time when you can’t put off embracing new technology any longer. Read more

Review of Ballerina, A Programming Language For Microservices And APIs

As the API space has grown and transitioned, there have been several major sea changes in what an effective language in the industry looks like. Moving away from classical server-client architecture and into the realm of serverless or other new paradigms can leave old languages feeling inadequate. Read more

How Workarounds Reveal the True Needs of Your API Consumers

Workarounds are clever, but less than ideal solutions to problems that shouldn’t really exist. In the world of APIs, an example of this might be scraping an application’s frontend to make up for endpoints that don’t exist.

At first sight, workarounds may seem like a bad thing. Read more