API Fundamentals

This section covers the basics of API design and development, including common features which themselves apply to all endpoints, but are not necessarily structural in nature. These are the things that every API should have, regardless of the underlying technology, architecture, or business domain.


API Versioning and Deprecation

API versioning is essential for managing changes to your API. This document outlines how this is done.

Entity Versioning and Conflict Management

How to manage versioned entities and prevent conflicts in your API.

Content-Type Negotiation

How to handle requests for different content types in your API.

Unique Identifiers

How to generate and use unique identifiers in your API.