Software Development free courses

Master the TrickProfessionalFree

REST API Design Foundations

Design resource-oriented endpoints with clear request contracts, authorization and retry behavior.

3 reading lessons · about 30 min ·written by MTT

The idea

Resource URLs identify entities or collections. GET retrieves without intentionally changing server state, POST commonly creates or requests processing, PUT can replace a resource and DELETE removes it. Idempotence concerns the intended server effect of repeated equivalent requests, not whether every response is identical.

Worked example

GET /courses/42 retrieves a fictional course. DELETE /saved-courses/42 removes a saved entry; a repeated delete may return a different status while the intended final absence stays the same. Repeating an unprotected create request can instead produce duplicate resources.

Try it

Design collection and individual URLs for fictional notes. Choose methods for listing, creating, replacing and deleting. Explain which repeated operations should have the same intended effect and why that does not require identical response bodies.

Lesson 1 of 3 · About 10 min

Name resources and choose methods

Check your understanding

Course quiz

Finish the course to unlock the quiz

Complete all 3 lessons and 5 questions open up here. You have 3 to go.

What you will learn

  • Match methods to resource operations
  • Separate validation from authorization
  • Specify pagination and safe retry semantics

Before you start

Prerequisites
Basic web-request familiarity. Use fictional resources; no public API account is required.
Cost
Free introductory reading lessons, exercises and quiz. Optional third-party tools, hosting or AI subscriptions may cost money.

Original introductory lessons and assessment by Master the Trick. Estimated times include the suggested exercises.