REST APIs

Resource-oriented HTTP interfaces.

3 subjects · 13 topics

Subjects covering this category

3 subjects

Subject · Beginner to Advanced
API Design
Designing HTTP APIs that clients can understand, call safely, and keep using as the API changes.
- HTTP for API Designers
- Designing the Contract
- Repeats, Retries and Long Jobs
14 topics · 132 cardsnot started
Subject · Beginner to Advanced
System Design
Turning a product's requirements into a first design for a web system, and knowing what each part is there for.
- Starting a Design
- The Parts of a System
- Moving Data Around
11 topics · 100 cardsnot started
Subject · Intermediate to Advanced
Spring Boot
Building a REST service with Spring Boot: wired to real data, validated, and fast enough to trust in production.
- Spring Boot Essentials
- Building REST APIs
- Data Access
12 topics · 77 cardsnot started

In REST APIs itself

13 topics

API Design
REST and Resource-Oriented Design
REST and resource design: naming the things an API exposes and the paths that reach them, with filtering, sorting and actions that are not plain updates.
Beginner to Advanced11 cards · 7 qnot started
API Design
HTTP Methods and Their Guarantees
HTTP methods for APIs: what GET, POST, PUT, PATCH and DELETE promise, and which are safe to repeat.
Beginner to Intermediate10 cards · 7 qnot started
API Design
Request and Response Contracts
API contracts: the fields, types and formats a client and server agree on, written down so machines can check them.
Beginner to Advanced10 cards · 7 qnot started
API Design
HTTP Status Codes
HTTP status codes for APIs: choosing the code that tells a client what happened and what to do next.
Beginner to Intermediate9 cards · 7 qnot started
API Design
Synchronous and Asynchronous APIs
Asynchronous APIs: answering a long job with 202 Accepted and a status to check, and sending signed webhooks a receiver can trust.
Beginner to Advanced9 cards · 5 qnot started
API Design
Versioning and Evolving an API
Versioning an API: telling breaking changes from safe ones, and retiring an old version without stranding its clients.
Beginner to Advanced9 cards · 6 qnot started
API Design
REST, GraphQL and gRPC
REST, GraphQL and gRPC: what each API style exposes, and how to choose one for an integration.
Beginner to Advanced9 cards · 5 qnot started
API Design
Error Responses
API error responses: one error format a client can branch on, with enough detail to fix the request and nothing an attacker can use.
Beginner to Intermediate8 cards · 5 qnot started
API Design
Designing an API End to End
Designing an API end to end: from requirements to reviewed endpoints, errors and a contract for one feature.
Intermediate to Advanced7 cards · 6 qnot started
API Design
Idempotency Keys: Retrying a Write Safely
Idempotency keys: letting a client retry a payment or an order after a timeout without it happening twice.
Beginner to Advanced6 cards · 4 qnot started
Spring Boot
Mapping Requests
Mapping HTTP requests to controller methods: verbs and paths, reading request data, and choosing the response.
Intermediate to Advanced6 cards · 4 qnot started
System Design
Client-Server Communication Patterns
Client-server communication: polling, server-sent events, WebSockets and webhooks, chosen by who sends and how often.
Beginner to Intermediate10 cards · 5 qnot started
System Design
API Pagination
API pagination with offsets and cursors: returning large results a page at a time without skipping rows or slowing down.
Beginner to Intermediate8 cards · 5 qnot started