Learning Paths / Learn API Design

api-design
beginner
5h estimated

Learn API Design

Design clean, reliable APIs: REST basics, HTTP methods and status codes, error handling, versioning, pagination, auth, and GraphQL.

Start learning →

REST Foundations

  1. 1

    REST Basics

    The core principles of resource-oriented REST APIs and how clients talk to them

  2. 2

    HTTP Methods

    How GET, POST, PUT, PATCH, and DELETE map to actions on API resources

  3. 3

    Status Codes

    What the common 2xx, 4xx, and 5xx response codes mean and when to use them

Robust APIs

  1. 1

    Error Handling

    Designing clear, consistent error responses that clients can act on

  2. 2

    Versioning

    Strategies for evolving an API without breaking existing clients

  3. 3

    Pagination

    Returning large collections in manageable pages using offset or cursor strategies

  4. 4

    Authentication

    How APIs verify who is calling using API keys, bearer tokens, and JWTs

Beyond REST

  1. 1

    GraphQL Basics

    How GraphQL lets clients request exactly the data they need from a single endpoint