RESTful APIs

Resource-oriented API design.

RESTful APIs is taught here in 3 lessons, running from Resource modelling and methods through to Versioning and error shapes. Each lesson takes one topic, shows the working code, and links onward to the next, so the course can be read straight through in order.

TrackXML & Web Services
Lessons3
LevelBeginner
Reading timeabout 39 minutes
PrerequisitesHelpful, but not required: SOAP

Lessons

  1. Resource modelling and methodsDesigning URLs around resources, mapping actions to HTTP methods, and the idempotency guarantees clients depend on.
  2. Status codes, pagination and filteringThe status codes an API should return, offset versus cursor pagination, and the query parameters clients expect for filtering, sorting and fields.
  3. Versioning and error shapesHow to evolve an API without breaking clients, and the error format that makes failures actionable.

More in XML & Web Services

XML XPath XSLT SOAP RSS & Atom

FAQ

How long does the RESTful APIs course take?
It has 3 lessons, about 39 minutes of reading. Expect roughly twice that if you type out and run every example.
Do I need prior experience for RESTful APIs?
Not strictly. It helps to have read SOAP first, because some lessons build on it, but every lesson explains its own assumptions.
What should I read after RESTful APIs?
Continue with RSS & Atom (3 lessons), the next course in XML & Web Services.

Last refreshed 2026-09-18.