6강. Header와 Content-Type

?1. 이번 강의에서 해결할 문제

게임 기록·랭킹 API를 테스트하면서 표현 형식과 인증 정보를 전달하는 HTTP Header를 구성하는 문제를 해결합니다. 수동으로 한 번 성공하는 데서 끝내지 않고 같은 결과를 다시 확인할 수 있는 요청으로 남깁니다.

✓2. 학습 목표

✓이 강의를 마치면

• 이번 주제의 HTTP 계약을 설명할 수 있습니다.
• Postman에서 성공과 실패 요청을 각각 구성할 수 있습니다.
• PowerShell에서 핵심 요청을 재현하고 결과를 판정할 수 있습니다.

◇3. 핵심 개념

헤더는 본문 바깥의 메타데이터입니다. Content-Type: application/json은 보내는 본문의 형식을, Accept: application/json은 받고 싶은 형식을 알립니다. Authorization에는 인증 정보가 들어가므로 로그·스크린샷·공유 컬렉션에 실제 값을 남기지 않습니다.

✎4. 단계별 실습

실습 경로: C:\dev\game-ranking-api-tests

1. Postman의 Headers 탭에서 자동 생성 헤더와 직접 입력 헤더를 구분합니다.
2. POST 초안에 Content-Type: application/json과 Accept: application/json을 설정합니다.
3. Content-Type을 일부러 빼거나 text/plain으로 바꿔 오류를 비교합니다.

PowerShell

$headers = @{ Accept = "application/json" }
Invoke-RestMethod -Method Get -Uri "http://127.0.0.1:8000/rankings" -Headers $headers

Postman의 버튼·탭 이름은 버전에 따라 달라질 수 있습니다. 메뉴가 다르면 설치된 앱의 도움말과 Postman 공식 문서를 먼저 확인합니다.

→5. 요청과 응답이 동작하는 이유

서버는 Content-Type을 보고 본문을 어떤 파서로 해석할지 결정합니다. Accept는 클라이언트의 선호 표현을 전달합니다. 헤더 이름은 대소문자를 구분하지 않지만 값의 형식과 인증 접두사는 계약대로 맞춰야 합니다.

!6. 자주 하는 실수와 해결법

!자주 하는 실수

• 실수: Content-Type과 Accept를 뒤바꿈 해결: 보내는 형식과 받고 싶은 형식을 분리합니다.
• 실수: JSON 본문만 넣고 Content-Type을 누락함 해결: Postman Body에서 raw JSON을 선택하고 생성된 헤더를 확인합니다.
• 실수: 실제 토큰을 헤더에 고정함 해결: 16강의 로컬 환경 변수로 옮깁니다.

✎7. 직접 실습

✎직접 실습

1. 정상 JSON 헤더 요청을 저장합니다.
2. 잘못된 Content-Type 요청을 실패 폴더에 저장합니다.
3. 응답 헤더에서 Content-Type을 확인합니다.

완료 후 Postman 요청을 저장하고, 실제 API Key·JWT·비밀번호가 이름·본문·스크립트·export 파일에 없는지 확인합니다.

?8. 이해 점검 질문 3개

?이해 점검

1. Content-Type은 요청의 무엇을 설명하나요?
2. Accept와 Content-Type의 차이는 무엇인가요?
3. Authorization 값을 요청에 직접 쓰면 왜 위험한가요?

■9. 핵심 요약

■핵심 요약

헤더는 본문의 해석과 인증 같은 부가 계약을 전달합니다. 자동 생성 여부를 확인하고 민감한 값은 로컬 변수로 분리합니다.