Posts Tagged: OpenAPI Specification

4 Ways Your API Specification Can Fall Short (And What to Do About It)

The use of API specification tooling like the OpenAPI Specification has revolutionized the way we design, build, and manage APIs. In addition to helping us plan out functionality, generate documentation, and run tests, a specification can serve the all-important role of the API contract: defining precisely what consumers can expect from our API. Read more

Is OpenAPI the Gateway to DevOps Success?

It’s not an understatement to say that OAS (OpenAPI Specification) has changed the way many developers design their APIs, with its standardized format allowing for easier adoption and implementation of APIs.

However, the verb used in that last sentence is telling: it talks about how developers “design” their APIs, rather than how they “power” or “utilize” them. Read more

AsyncAPI vs OpenAPI: What’s The Difference?

The world of APIs is often one of competing standards, interests, and solutions. While we tend to talk about the API space as a cohesive community, the reality is that APIs on the internet encompasses something more universal.

In the API documentation space, this ultimately comes down to a question of consumption. Read more

Why You Should Auto-Generate API Client Libraries

Client libraries are one of few ways to dramatically improve Developer Experience (DX) for your APIs. However, with all the programming languages your developers use, creating client libraries can be quite a challenge — and that’s not to mention the maintenance that comes with every update to your APIs. Read more

5 API Design Trends to Look Out for in 2019

2019 will see the growing popularity of plenty of new and powerful approaches to building great APIs. Between growing amounts of data, a 21st century need-for-speed, and ever-tighter regulations, secure and effective API design is more important than ever — and we find that observing trends can be the best way to identify what’s working for others. Read more