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

PUT·PATCH·DELETE 요청과 안전한 검증

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

13강. PUT·PATCH·DELETE 요청과 안전한 검증

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

게임 기록·랭킹 API를 테스트하면서 데이터 변경 전후를 조회하고 PUT·PATCH·DELETE의 영향을 안전하게 확인하는 문제를 해결합니다. 수동으로 한 번 성공하는 데서 끝내지 않고 같은 결과를 다시 확인할 수 있는 요청으로 남깁니다.

2. 학습 목표​

3. 핵심 개념​

변경 요청은 응답만 맞아도 충분하지 않습니다. 대상 ID를 GET으로 사전 확인하고, 변경 후 다시 GET해 저장 결과를 검증합니다. DELETE는 테스트 전용 데이터에만 사용하며 상태 코드가 204라면 본문이 없어야 합니다. 운영·공유 환경에서는 명시적 승인 없이 실행하지 않습니다.

4. 단계별 실습​

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

  1. GET {{baseUrl}}/records/{{recordId}}로 대상과 현재 값을 확인합니다.
  2. PATCH로 score 하나만 바꾸고 다른 필드가 유지됐는지 재조회합니다.
  3. PUT은 API가 요구하는 전체 필드를 보냅니다.
  4. DELETE 전 다시 ID를 확인하고 삭제 뒤 GET이 404인지 검증합니다.
PowerShell
$baseUrl = "http://127.0.0.1:8000"
$recordId = 99 # 반드시 테스트 전용 ID로 교체
Invoke-RestMethod -Uri "$baseUrl/records/$recordId"
$body = @{ score = 1600 } | ConvertTo-Json
Invoke-RestMethod -Method Patch -Uri "$baseUrl/records/$recordId" -ContentType "application/json" -Body $body

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

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

PATCH는 전달된 필드만 수정하도록 구현되고 PUT은 전체 표현을 교체하는 계약이 흔합니다. 사전·사후 GET은 잘못된 ID와 의도하지 않은 필드 변경을 탐지하는 안전 장치입니다.

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

7. 직접 실습​

8. 이해 점검 질문 3개​

9. 핵심 요약​

MINI QUIZ

PUT·PATCH·DELETE 요청과 안전한 검증 미니 퀴즈

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

0 / 2
  1. 문제 1“PUT·PATCH·DELETE 요청과 안전한 검증” 작업 전 검토에서 채택해야 할 안전 기준은 무엇인가요?
  2. 문제 2‘ID 확인 없이 DELETE 실행’ 실수를 판단할 때 “PUT·PATCH·DELETE 요청과 안전한 검증” 강의가 제시한 기준은 무엇인가요?

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

LESSON STATUS

학습을 마쳤나요?

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

13강. PUT·PATCH·DELETE 요청과 안전한 검증 미완료 상태