Related articles

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 important than ever — and we find that observing trends can be the best way to identify what’s working…

Read More

8+ OpenAPI Linters

OpenAPI is now a wiy-adopted method for describing web APIs. With that fact comes the pressure to validate these specifications are up to date, accurately constructed, and presented for optimal developer usage. Especially with the shift from OpenAPI v2 to v3, developers may require further assistance to ensure their specification matches the current v3 structure…

Read More

APIcurio Walkthrough

We walkthrough using APIcurio, an API design editor supporting OpenAPI Spec.Having a thoroughly documented, machine-readable API is considered top of the development. However, creating a consistent format for the API and documentation is challenging with no outside guidance or structure. In an effort to provide this structure for API creators, the OpenAPI Specification was…

Read More

Tooling Review: Swagger Inspector

Testing is often considered to be a secondary consideration at the end of the development lifecycle. The common thought is that APIs are tested after they are built, and that any issues found should be addressed during these later stages. While this is certainly a method that can iver a finished product, utilizing testing in such…

Read More

Why You Should Be Designing APIs to Spec

There’s a good reason why building APIs can be extremely tough and time-consuming: they have to cater to both human and machine needs. Inherently, this is pretty difficult. Machines are picky and rely on pure logic; they crave rigid, hierarchical structures and definite instructions. On the other hand, humans prefer things to work on an…

Read More

7 Items No API Documentation Can Live Without

Web APIs are highly variable things – they can be custom-built, designed around a single purpose, all-encompassing, and almost everything in between. Shifting requirements dictate what the interface is comprised of. Due to this, it’s hard to find commonalities between APIs and their user-facing portals. That being said, there are some basic requirements that, despite…

Read More