HTTP & REST Quest

Tracks

1. 01🧱Foundations — 이미 쓰고 있던 그 wire

   0/7 lessons

   TCP, TLS, HTTP version, method, header, status code family

   REST design 도 auth 도 caching 도 전부 그 전에 — wire 가 있어. 7개 lesson 이 'HTTP 는 웹의 우편 서비스야' 부터 request anatomy, TLS handshake, HTTP/1.1 vs 2 vs 3 진화, 모든 method, 모든 header category, 1xx-5xx status code 의 polymorphic dispatch 까지 데려가. 끝날 때쯤이면 DevTools 에서 request 열어봐도 그리스어처럼 안 보일 거야.

   Lesson list (7)

   • 01
     HTTP — 웹의 우편 서비스~10 min · foundations, intuition, postal-service, stateless
   • 02
     Request & Response Anatomy — 절대 안 바뀌는 네 부분~11 min · foundations, anatomy, request, response
   • 03
     TCP & TLS — 안 보고 사는 그 layer cake~11 min · foundations, tcp, tls, https, transport
   • 04
     HTTP Versions — 같은 semantics, 다른 wire~11 min · foundations, http1, http2, http3, quic, multiplexing
   • 05
     Methods Overview — Server 가 알아듣는 일곱 verb~10 min · foundations, methods, verbs, overview
   • 06
     Headers by Category — 손에 쥘 수 있는 taxonomy~11 min · foundations, headers, metadata, taxonomy
   • 07
     Status Code Families — Lookup table 가 아니라 polymorphic protocol~12 min · foundations, status-codes, polymorphic, dispatch

   ✓퀴즈 · 6 문제→

2. 02🎯Semantics — Method 가 실제 약속하는 invariant

   0/6 lessons

   Idempotency, safety, cacheability, content negotiation, conditional request, versioning

   Foundations 가 method 이름 알려줬어. Semantics 는 각 method 가 client, proxy, CDN 한테 뭘 약속하는지 알려줘. Idempotency 가 진짜 invariant (verb 매핑은 결과야). Status code 는 polymorphic protocol (lookup table 아냐). Content negotiation 은 client 와 server 가 미리 약속 없이 format 합의하는 방법. Conditional request 는 cache 계약. 끝날 때쯤이면 모든 PUT vs POST 선택을 민간 전승 아닌 세 속성 invariant 로 방어할 수 있어.

   Lesson list (6)

   • 01
     Idempotency & Safety — 진짜 invariant (민간 전승이 지는 곳)~12 min · semantics, idempotency, safety, cacheability
   • 02
     Status Code Dispatch — 제 값 하는 specific code~11 min · semantics, status-codes, dispatch, refinement
   • 03
     Content Negotiation — 미리 약속 안 하고 format 합의~11 min · semantics, content-negotiation, accept, vary
   • 04
     Conditional Request — Cache 계약과 optimistic locking~12 min · semantics, conditional-requests, etag, if-match, 304
   • 05
     Versioning 전략 — Client 안 깨고 API 진화하기~11 min · semantics, versioning, evolution, deprecation
   • 06
     Method Decision Table — 계약 맞는 verb 골라~10 min · semantics, methods, decision, synthesis

   ✓퀴즈 · 6 문제→

3. 03🏛️REST Design — Resource, URI, HATEOAS 정직하게

   0/7 lessons

   Resource vs RPC, URI 설계, HATEOAS 모순, pagination, error envelope

   REST 는 Fielding 이 2000년에 묘사한 architectural style. 2026년에 'REST API' 라는 이름으로 ship 되는 건 대부분 HTTP 옷 입은 RPC. 둘 다 동작; 이 트랙이 어느 게 어느 건지 구분하고, 둘 중 뭐든 잘 설계하고, dissertation 안 읽고 HATEOAS 논쟁 그만하게 가르쳐. Lesson 7 개: resource vs RPC 모델, URI 설계 규칙, HATEOAS 둘 (순수와 정직), pagination 패턴, query shape, error envelope 설계.

   Lesson list (7)

   • 01
     Resource vs RPC — 두 mental model, 둘 다 유효~11 min · rest-design, resources-vs-rpc, mental-model
   • 02
     URI 설계 — 명사, 복수, 살려주는 규칙~10 min · rest-design, uri-design, naming
   • 03
     HATEOAS — Fielding 이 실제 쓴 것 (순수 버전)~12 min · rest-design, hateoas, fielding, pure
   • 04
     HATEOAS — 정직한 결산 (2026년에 ship 되는 것)~11 min · rest-design, hateoas, honest, rpc-over-http
   • 05
     Pagination — Cursor 가 offset 이기는 이유 부딪힐 거~11 min · rest-design, pagination, cursor, offset
   • 06
     Filtering, Sorting, Sparse Fieldset — Query 도구상자~10 min · rest-design, filtering, sorting, fieldsets
   • 07
     Error Envelope 설계 — Client 한테 작업할 거 줘~10 min · rest-design, errors, error-envelope, rfc7807

   ✓퀴즈 · 6 문제→

4. 04🛡️Auth & Security — Wire-Level, 손짓 발짓 아님

   0/6 lessons

   Bearer, API key, JWT, PKCE 가진 OAuth2, CORS, rate limiting

   대부분 API auth 버그가 내부 아무도 이해 못 하는 복붙 OAuth flow 에서 옴. 이 트랙이 wire-level 이야기 풀어: HTTP Basic 과 Bearer (원조), API key vs 단기 token (각각 언제 맞나), JWT 구조와 refresh flow, PKCE 가진 OAuth2 (현대 canonical 패턴), 강제된 server-선언 정책으로서의 CORS, 429 + Retry-After 통한 rate limiting. Lesson 6 개; 라이브러리 전에 개념.

   Lesson list (6)

   • 01
     HTTP Basic & Bearer — Protocol 이 아는 두 auth scheme~10 min · auth-security, basic, bearer, authorization
   • 02
     API Key vs 단기 Token — 누설 위험으로 선택~10 min · auth-security, api-keys, tokens, rotation
   • 03
     JWT & Refresh — Format, claim, refresh 춤~12 min · auth-security, jwt, claims, refresh
   • 04
     OAuth2 with PKCE — 현대 canonical flow~12 min · auth-security, oauth2, pkce, authorization-code
   • 05
     CORS Deep Dive — Server-선언 정책, 브라우저-강제~12 min · auth-security, cors, preflight, browser
   • 06
     Rate Limiting — 429, Retry-After, 아래의 algorithm~10 min · auth-security, rate-limiting, 429, retry-after

   ✓퀴즈 · 6 문제→

5. 05⚡Caching & Performance — 이미 가진 계약

   0/5 lessons

   Cache-Control, ETag, conditional GET, CDN 층, 압축, HTTP/2 multiplexing

   HTTP 가 대부분 API 가 무시하는 정교한 caching protocol 가짐. 이 트랙이 사용법 가르쳐 — server 와 intermediary 간 계약으로서의 Cache-Control, body 전송 완전 건너뛰는 fast path 로서의 conditional GET, CDN 층 (브라우저 / edge / origin) 과 네 header 가 어느 거 target 하는지, 압축 negotiation (gzip / brotli / zstd), HTTP/1.1 에서 상속된 client 설계 가정을 바꾸는 HTTP/2 multiplexing 승리. Lesson 5 개.

   Lesson list (5)

   • 01
     HTTP Cache Header — Server 가 intermediary 한테 말하는 계약~11 min · caching-perf, cache-control, etag, last-modified
   • 02
     Conditional GET — Byte 건너뛰는 fast path~10 min · caching-perf, conditional-get, 304, etag-revisited
   • 03
     CDN 층 — 브라우저, edge, origin (그리고 네 header 어디 가나)~10 min · caching-perf, cdn, edge, origin
   • 04
     Compression & Keep-Alive — 공짜 byte 와 공짜 round trip~10 min · caching-perf, compression, gzip, brotli, keep-alive
   • 05
     HTTP/2 Multiplexing — Client 설계가 뭐 바뀌나~10 min · caching-perf, http2, multiplexing, client-design

   ✓퀴즈 · 5 문제→

6. 06🌊Streaming & Async — REST 가 끝나는 곳

   0/5 lessons

   Polling → long-polling → SSE → chunked transfer → WebSocket handoff → webhook

   REST 가 request/response. Real-time, push, long-running operation 이 다른 패턴 필요. 이 트랙이 spectrum 걸음: polling (싸고, 낭비적), long-polling (server 가 연결 보유), SSE (HTTP 위 one-way server-to-client streaming), chunked transfer (SSE 가 타는 substrate), WebSocket handoff (full duplex 필요할 때), webhook (inverted REST), 202 + Location async 패턴. Lesson 5.

   Lesson list (5)

   • 01
     Polling → Long-Polling — WebSocket 전 싼 real-time~10 min · streaming-async, polling, long-polling
   • 02
     Server-Sent Events — One-Way Streaming, 이미 네 브라우저에~11 min · streaming-async, sse, event-stream, ai-streaming
   • 03
     Chunked Transfer Encoding — HTTP/1.1 가 크기 모르고 stream 하는 법~9 min · streaming-async, chunked-transfer, http1
   • 04
     REST 끝나고 WebSocket 시작하는 곳 — handoff 결정~10 min · streaming-async, websocket, rest-vs-ws
   • 05
     Webhook & Async-202 — Inverted REST 와 polling 패턴~10 min · streaming-async, webhooks, 202, async

   ✓퀴즈 · 5 문제→

7. 07🚀Production — 진짜 일

   0/6 lessons

   Observability, curl, httpie/Postman, OpenAPI, client retry, API gateway

   Protocol 디테일이 필수; production 에 API 돌리기가 충분. 이 트랙이 운영 층 가르쳐: 분산 trace 통해 thread 하는 correlation ID, 보편 debug 도구로서 curl, 실제 잡을 GUI client, wire 의 documentation 으로서 OpenAPI, 부분 실패 생존하는 client 설계 (retry + circuit breaker), API 장기 관리 (gateway + versioning lifecycle). Lesson 6.

   Lesson list (6)

   • 01
     Observability & Correlation ID — 분산 미로 통과하는 thread~10 min · production, observability, correlation-id, tracing
   • 02
     curl — 거짓말 안 하는 진짜 도구~10 min · production, curl, debugging
   • 03
     httpie / Postman / Insomnia — 실제 잡을 도구~9 min · production, httpie, postman, insomnia, gui-clients
   • 04
     OpenAPI & JSON Schema — API 의 machine-readable 계약~11 min · production, openapi, json-schema, spec
   • 05
     Client 설계 — Retry, Backoff, Circuit Breaker~11 min · production, retry, backoff, circuit-breaker
   • 06
     API Gateway & Versioning Lifecycle — Long game~10 min · production, api-gateway, versioning, deprecation

   ✓퀴즈 · 6 문제→

8. 08🎓Epilogue — cwkPippa 가 reference + 다음 어디

   0/4 lessons

   실제 REST codebase 걷기, REST 아닌 거 봄, 자기 만들기, 바깥 봄

   이론 트랙 7; 반성 lesson 4. 첫 번째가 동작하는 REST + SSE + WebSocket reference 로 cwkPippa 의 backend routes/ 걸음. 두 번째가 정직한 'REST 안 쓸 때' (gRPC, GraphQL, RPC) 섹션. 세 번째가 배운 거 적용하는 작은 CRUD end-to-end. 네 번째가 다음 어디 갈지 로드맵 — 이 퀘스트가 의도적으로 미룬 더 깊은 주제.

   Lesson list (4)

   • 01
     cwkPippa 가 REST reference — 실제 codebase 걷기~10 min · epilogue, cwkpippa, synthesis, self-reference
   • 02
     REST 안 쓸 때 — gRPC, GraphQL, 맞는 도구 질문~10 min · epilogue, grpc, graphql, alternatives
   • 03
     자기 CRUD 만들기 — 모든 거 cement 하는 end-to-end~12 min · epilogue, crud, synthesis, capstone
   • 04
     다음 어디 — 이 퀘스트가 미룬 로드맵~8 min · epilogue, roadmap, next-steps

   ✓퀴즈 · 4 문제→