Engineering, made clearer.Find a tool /
Learn · Practise · Understand

Learn REST APIs

Resource-oriented APIs expose identifiers and representations through HTTP semantics. Stateless requests carry their processing context.

3 sections · 10 explained questions · About 10 minutesAll lessons →

Read each short explanation, work through the example, then answer a pop quiz. Every answer explains the reasoning. Incorrect answers unlock a fresh question on the same idea; the full lesson contains ten questions.

01Understand the basics

Ready to learn

Representational State Transfer (REST) describes constraints for networked systems. A practical resource API uses stable URLs, HTTP methods and clear representations. Each request should carry the context needed to process it; the server should not rely on an earlier request to know what the caller means.

Section 1 question · 4 variations
What should GET do?

02Design collections

Ready to learn

A collection can contain more records than one response should return. Pagination splits the result into manageable pages. Stable ordering and a documented cursor or offset make traversal predictable.

Try a different value

Move the slider or use the arrow keys to see what changes.
ClientGET /items?limit=206 pages200 + representation
Section 2 question · 3 variations
How many pages hold 120 records at 30 records per page?

03Keep the contract clear

Ready to learn

Validate input, authorise resource access, and return a consistent error shape. A correct-looking URL does not prove that the caller may access the resource.

Section 3 question · 3 variations
Where should access to an individual order be checked?

Put it to work

Apply what you’ve learned using the related tools.