API Design

Overview

About API Design

APIs are the contracts that let software talk to software, and a well-designed one is easy to learn, hard to misuse, and safe to evolve. This course walks through API design the way most developers actually learn it. It starts with Introduction to API Design (what APIs are, why design matters, and the principles behind good ones) and REST Fundamentals & Resource Modeling (REST constraints, resources, URLs, and naming).

Next comes HTTP, Methods & Status Codes: using the protocol properly, including idempotency and caching. That leads into Request & Response Design for payloads, pagination, filtering, and consistent errors, and Authentication & Authorization for protecting your API with keys, tokens, OAuth 2.0, and scopes.

OpenAPI & Documentation covers describing your API with a machine-readable contract and generating docs, and Versioning & Evolution covers changing an API without breaking the people who depend on it. GraphQL, gRPC & Beyond REST covers the alternatives and when to reach for them.

Finally, Performance, Rate Limiting & Security covers keeping APIs fast and safe, and Testing, Monitoring & Governance covers verifying contracts, watching live traffic, and keeping many APIs consistent: the natural last step once designing endpoints feels routine.

Content

10 modules
01

Introduction to API Design

What APIs are, why design matters, and the principles behind interfaces that developers actually enjoy using.

API BasicsDesign PrinciplesDeveloper Experience
02

REST Fundamentals & Resource Modeling

The constraints behind REST, and how to turn your domain into clear resources, URLs, and relationships.

REST ConstraintsResources & URIsNaming Conventions
03

HTTP, Methods & Status Codes

Using HTTP the way it was intended: methods, headers, status codes, idempotency, and caching semantics.

HTTP MethodsStatus CodesIdempotency
04

Request & Response Design

Shaping payloads and behavior: JSON structure, pagination, filtering, sorting, and consistent error responses.

JSON PayloadsPagination & FilteringError Handling
05

Authentication & Authorization

Protecting your API with API keys, tokens, and modern standards, and deciding who can do what.

API KeysOAuth 2.0 & JWTScopes & Roles
06

OpenAPI & Documentation

Describing your API with a machine-readable contract, generating docs, and designing contract-first.

OpenAPI SpecSwagger UIContract-First Design
07

Versioning & Evolution

Changing an API without breaking its consumers: versioning strategies, deprecation, and backward compatibility.

Versioning StrategiesBreaking ChangesDeprecation
08

GraphQL, gRPC & Beyond REST

When REST isn't the best fit: schema-driven GraphQL, high-performance gRPC, webhooks, and real-time APIs.

GraphQLgRPC & ProtobufWebhooks & WebSockets
09

Performance, Rate Limiting & Security

Keeping APIs fast and safe with caching, rate limits, input validation, and the OWASP API Security risks.

CachingRate LimitingOWASP API Top 10
10

Testing, Monitoring & Governance

Testing contracts and behavior, monitoring live APIs, and keeping many APIs consistent across a team.

Contract TestingMonitoringAPI Governance

What You Can Do After This Course

By the end of the curriculum you'll have worked through 5 hands-on projects and covered the core of what a back-end role expects from someone who "knows API design." Concretely, you'll be able to:

Design clear, consistent APIs — apply proven principles so your interfaces are easy to learn and hard to misuse.

Model resources and use HTTP properly — choose good URLs, methods, and status codes, and understand idempotency and caching.

Shape requests and responses — design payloads, pagination, filtering, and error formats that clients can rely on.

Secure your endpoints — implement authentication and authorization with tokens, OAuth 2.0, scopes, and roles.

Document with OpenAPI — write machine-readable contracts and generate documentation your consumers will actually use.

Evolve APIs without breaking clients — version, deprecate, and extend an API while keeping backward compatibility.

Choose the right style and ship with confidence — pick between REST, GraphQL, and gRPC, then test, monitor, and govern your APIs in production.