← All tutorials

Skill Zuno · skillzunos.com · System Design

API Design tutorial

Learn API Design on Skill Zuno. This API Design tutorial covers New, Easy, Medium, Hard, and Diff levels so you can study practical API Design problems on skillzunos.com.

Open API Design on Skill Zuno

Also see the API Design interview questions.

API design defines how clients and services talk to a system: the resources, operations, data formats and error behaviour. A good API is consistent, predictable, secure and can evolve without breaking clients. Interviews cover REST principles, choosing between REST, GraphQL and gRPC, pagination, versioning, idempotency and error handling.

API Design topics covered

  • REST principles — Resources as nouns, HTTP methods as verbs, status codes and stateless requests.
  • REST, GraphQL and gRPC — Comparing them for public APIs, flexible front ends and internal services.
  • Pagination — Offset versus cursor pagination and why cursors scale better.
  • Versioning and compatibility — Evolving an API without breaking existing clients.
  • Idempotency and retries — Making POST requests safe to retry with idempotency keys.
  • Errors, authentication and rate limits — Consistent error bodies, API keys and OAuth, and quotas.

What you can learn

  • API Design tutorial for beginners and experienced developers
  • Level-based practice: New, Easy, Medium, Hard, and Diff
  • System Design topics alongside API Design on skillzunos.com

More System Design tutorials

All tutorials