본문으로 건너뛰기
API 도구 기초집LESSON 07

JSON Request Body와 응답 데이터 읽기

난이도입문 → 초급
예상 시간30분
선수지식이전 강의

7강. JSON Request Body와 응답 데이터 읽기

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

게임 기록·랭킹 API를 테스트하면서 유효한 JSON 요청 본문을 작성하고 중첩 응답 데이터를 읽습니다. 수동으로 한 번 성공하는 데서 끝내지 않고 같은 결과를 다시 확인할 수 있는 요청으로 남깁니다.

2. 학습 목표​

3. 핵심 개념​

JSON 객체는 큰따옴표로 감싼 키와 문자열, 숫자, 불리언, null, 배열, 객체를 표현합니다. Postman에서는 Body → raw → JSON을 선택합니다. JSON 문법이 맞아도 API 스키마의 필드명·타입·필수 조건이 다르면 FastAPI가 일반적으로 422 검증 오류를 돌려줍니다.

4. 단계별 실습​

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

  1. 플레이어 생성 요청에 JSON 본문을 넣습니다.
  2. Send 후 응답의 id, nickname, created_at을 확인합니다.
  3. nickname을 제거하거나 숫자로 바꿔 검증 오류의 위치와 메시지를 읽습니다.
PowerShell
$body = @{ nickname = "test-player"; region = "KR" } | ConvertTo-Json
Invoke-RestMethod -Method Post -Uri "http://127.0.0.1:8000/players" -ContentType "application/json" -Body $body

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

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

ConvertTo-Json은 PowerShell 객체를 JSON 문자열로 직렬화합니다. 서버는 JSON을 읽어 Pydantic 모델로 검증하고, 성공하면 생성한 리소스를 다시 JSON으로 직렬화합니다.

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

7. 직접 실습​

8. 이해 점검 질문 3개​

9. 핵심 요약​

MINI QUIZ

JSON Request Body와 응답 데이터 읽기 미니 퀴즈

선택 즉시 정답과 해설을 확인할 수 있습니다. 결과는 이 브라우저에만 저장됩니다.

0 / 2
  1. 문제 1다음 중 “JSON Request Body와 응답 데이터 읽기”의 핵심 요약을 실제 상황에 맞게 적용한 것은 무엇인가요?
  2. 문제 2“JSON Request Body와 응답 데이터 읽기”의 작업 기준으로 ‘PowerShell 해시테이블을 그대로 JSON이라 생각함’을 진단하거나 바로잡은 선택은 무엇인가요?

답을 선택하면 진행 결과가 자동으로 저장됩니다.

LESSON STATUS

학습을 마쳤나요?

직접 실습과 점검 질문까지 확인한 뒤 완료로 표시하세요.

7강. JSON Request Body와 응답 데이터 읽기 미완료 상태