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

조회 API 테스트: 필터, 정렬, 페이지네이션

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

12강. 조회 API 테스트: 필터, 정렬, 페이지네이션

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

게임 기록·랭킹 API를 테스트하면서 랭킹 조회의 필터·정렬·페이지 경계값을 체계적으로 테스트하는 문제를 해결합니다. 수동으로 한 번 성공하는 데서 끝내지 않고 같은 결과를 다시 확인할 수 있는 요청으로 남깁니다.

2. 학습 목표​

3. 핵심 개념​

목록 API는 데이터가 많아질수록 필터, 정렬, 페이지네이션 계약이 중요합니다. 기본값·허용값·경계값·잘못된 값을 나눠 테스트하고, 정렬은 첫 항목만이 아니라 전체 인접 값의 순서를 확인합니다. 페이지 크기와 전체 개수 메타데이터도 계약에 포함합니다.

4. 단계별 실습​

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

  1. GET {{baseUrl}}/rankings?season=2026&sort=score_desc&page=1&limit=10을 저장합니다.
  2. Params 탭에서 각 값을 끄고 기본값을 확인합니다.
  3. page=0, limit=0, limit=1001, 잘못된 sort를 실패 요청으로 저장합니다.
  4. 같은 점수일 때 보조 정렬 기준이 안정적인지 확인합니다.
PowerShell
$uri = "http://127.0.0.1:8000/rankings?season=2026&sort=score_desc&page=1&limit=10"
$result = Invoke-RestMethod -Uri $uri
$result.items | Select-Object -First 3 player_id, score

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

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

서버는 쿼리 값을 검증한 뒤 WHERE, ORDER BY, LIMIT/OFFSET에 해당하는 처리를 적용합니다. 안정적인 정렬 키가 있어야 페이지 사이에서 항목이 흔들리지 않습니다.

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

7. 직접 실습​

8. 이해 점검 질문 3개​

9. 핵심 요약​

MINI QUIZ

조회 API 테스트: 필터, 정렬, 페이지네이션 미니 퀴즈

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

0 / 2
  1. 문제 1“조회 API 테스트: 필터, 정렬, 페이지네이션”에서 오류나 데이터 손실을 줄이는 선택은 무엇인가요?
  2. 문제 2“조회 API 테스트: 필터, 정렬, 페이지네이션”의 작업 기준으로 ‘내림차순을 눈으로만 확인함’을 진단하거나 바로잡은 선택은 무엇인가요?

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

LESSON STATUS

학습을 마쳤나요?

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

12강. 조회 API 테스트: 필터, 정렬, 페이지네이션 미완료 상태