19 docs tagged with "API-design"

Use stable façades and information hiding to manage complexity, evolve safely, and enforce boundaries

Design API contracts, implement semantic versioning, detect breaking changes, and evolve schemas while maintaining backward compatibility with existing clients.

Secure APIs with authentication, authorization, and scope management

Master REST, gRPC, GraphQL, WebSockets, and SSE. Choose the right API style for your service communication needs.

Design systems that evolve safely without breaking users and manage versions with semantic clarity.

Master inter-service communication: choose between REST, gRPC, GraphQL, and asynchronous patterns. Design APIs, service discovery, and message flows that scale.

The core building blocks of systems: components, the connectors between them, and the configurations that shape runtime behavior.

Prevent lost updates in concurrent environments with optimistic locking via ETags

Test API contracts between services; catch breaking changes early with CDC.

Design consistent, actionable error responses that guide API consumers

TL;DR

Scale APIs to handle large datasets with efficient query parameters

Design flexible, client-driven APIs with GraphQL schemas and resolvers

Define crisp boundaries and explicit, testable contracts to decouple teams and evolve systems safely.

Design systems where behavior matches user expectations, minimizing surprise and confusion.

Design REST resources with rich representations and hypermedia linking

Master the fundamentals of systems thinking for software architecture: components, connectors, configurations, interfaces, and abstractions to reason about change, risk, and evolution.

Master REST fundamentals: clear URIs, appropriate methods, and meaningful status codes

Manage API evolution while maintaining backward compatibility