REST APIs

The waiter of the internet: takes orders, never cooks.

▶ the lesson · ~35s · narrated · tap for sound

the intro

A REST API is how two programs talk over HTTP. The client sends a request to an endpoint, the server answers with data, usually JSON. The verbs are the vocabulary: GET reads, POST creates, PUT updates, DELETE removes. That is ninety percent of the job.

the sample

the classic request

GET /api/memes?sort=votes

HTTP/1.1 200 OK
[
  { "id": 1, "funny": true }
]

fun fact ✦

REST was Roy Fielding’s doctoral homework in 2000. Best. Homework. Ever.

the docs

quick hits about REST APIs

15-second answers · interviews, tips, trivia & hidden gems

🎤 interview

Which methods can you safely retry?

🎤 interview

401 vs 403?

🎤 interview

The status codes you actually ship

📚 tutorial

How do you name endpoints?

🔧 useful

Your list endpoint will die without this

💎 deep

Breaking changes without breaking apps?

🆕 update

REST or GraphQL?

🧠 trivia

HTTP 418 is real