요청 헤더
요청에 메타데이터 첨부 — 인증 포함
⏱ 예상 ~6분
01 · 읽기
모든 HTTP 요청은 헤더 를 가질 수 있어요 — 요청 본문과 함께 가는 key-value 메타데이터예요.
헤더는 서버에게 이런 걸 알려줘요: - 너가 누구인지 (Authorization) - 어떤 형식을 보내는지 (Content-Type) - 어떤 형식을 원하는지 (Accept) - 어떤 앱이 호출하는지 (User-Agent)
curl 에서는 -H "Key: Value" 로 헤더를 추가해요.
💡 상상해 봐요헤더는 요청을 담는 봉투예요. 본문은 안에 든 편지예요. 어떤 server 는 편지를 열기 전에 봉투를 읽어요 — 봉투가 잘못 쓰였으면 편지는 바로 휴지통이에요.
핵심 정리
- -H "Key: Value" 로 헤더 추가 — 여러 -H 플래그 사용 가능
- Authorization: Bearer TOKEN 은 가장 흔한 인증 패턴이에요
- Content-Type: application/json 은 본문이 JSON 임을 서버에 알려요
- 대부분 공개 API 는 비공개 데이터를 받으려면 Authorization 헤더가 필요해요
02 · 코드 예제
아래는 curl 명령에서 가장 흔한 헤더가 어떻게 생겼는지 보여줘요.
Authorization 헤더
curl https://api.example.com/data \
-H "Authorization: Bearer my-api-key-here"
여러 헤더
curl https://api.example.com/data \
-H "Authorization: Bearer my-api-key-here" \
-H "Accept: application/json" \
-H "X-Request-ID: abc123"
각 줄 끝의 \ 는 줄 연속이에요 — shell 에게 명령이 아직 끝나지 않았다고 알려줘요. 가독성을 위한 것뿐이에요, 전부 한 줄에 써도 돼요.
03 · 터미널 실습
먼저 /private 엔드포인트가 authorization 헤더 없이는 막혀 있다는 걸 확인해요.
(이 섹션은 인터랙티브해요 — JavaScript를 켜 주세요.)
04 · 퀴즈
curl 에 커스텀 헤더를 추가하는 플래그는 무엇인가요?
05 · 빈칸 채우기
헤더에 API 키를 보내려면: -H 'Authorization: _____ YOUR_KEY'.
06 · 터미널 실습
이제 Authorization 헤더를 추가해 봐요. Demo 키는 student-demo-key 예요.
(이 섹션은 인터랙티브해요 — JavaScript를 켜 주세요.)
07 · 퀴즈
curl 로 보호된 API 엔드포인트에 요청을 보냈는데 401 상태 코드가 왔어요. 무슨 뜻인가요?
- 인증되지 않았어요 — 서버가 Authorization 헤더를 요구해요
- 서버가 다운됐어요
- URL 이 존재하지 않아요
- 요청 본문 형식이 잘못됐어요
08 · 빈칸 채우기
헤더에 API 키를 보내는 표준 패턴은: Authorization: _____ YOUR_KEY.
⚠ 전체 인터랙티브 경험에는 JavaScript가 필요해요. JavaScript를 켜고 새로 고침해 주세요.
※ 이 사이트는 독립 운영되는 교육 프로젝트로, Anthropic의 공식 제품이 아니에요. Claude™ 는 Anthropic, PBC 의 상표예요.