Getting Started with APIs
Learn the basics of API technologies, their benefits and how to get started with it.
Using Smithy to Define Your APIs
Smithy is an OpenAPI alternative with an interface definition language that supports modeling, designing, and generating API documentation, client code, and server code.
Elevating API Documentation with Developer Workflows Using Docs as Code
Docs as Code has emerged as a powerful methodology that aligns documentation processes with software development workflows, treating documentation as a first-class citizen in the development lifecycle.
A Developer's Guide to API Design-First
Learn about the principles of API design-first and how it can benefit your organization.
AsyncAPI vs. OpenAPI: Which Specification Is Right for Your App?
Learn about the basic differences between AsyncAPI and OpenAPI that will help you pick one of them.
Creating Better API Architecture Diagrams
Learn about the various types of API architecture diagrams and some tips for creating them.
API Contracts - an Extended Introduction
This guide explains how API contracts can help your business, the best practices to follow, and gives some practical examples.
How to use and document polymorphism in APIs
Learn how to use `oneOf`, `anyOf` and `allOf` when writing an OpenAPI or AsyncAPI definition.
What are the different API types?
This is an introduction to the various API technologies that exist today, and their main use cases.