Proxyman 실습 · 배달 데모

실습 0 · SSL Proxying 확인

가장 먼저 해볼 실습입니다. 아래 버튼으로 GET /home 를 호출하면 서버에서 받은 JSON 데이터를 화면에 그립니다. Proxyman에 이 요청이 보이면 SSL Proxying 설정이 정상입니다.

🔎 Proxyman에서 확인할 것

요청이 HTTPS 로 잡히고 본문이 복호화되어 보이는지
Response 탭에서 { success, data } JSON 이 그대로 보이는지
안 잡히면 → 인증서 설치 / SSL Proxying 도메인 허용을 확인

실습 1 · Map Local — enum 케이스 다양하게

GET /order 의 status 값에 따라 UI가 바뀝니다. Map Local로 status 값을 바꿔 모든 케이스를 확인해 보세요. (기본값 COOKING)

🔎 바꿔볼 status 값 보기

PENDING 주문 접수 대기
ACCEPTED 주문 접수 완료
COOKING 조리 중 (기본 응답)
DELIVERING 배달 중 (라이더 정보 표시)
DELIVERED 배달 완료
CANCELED 주문 취소 (취소 사유 표시)

실습 2 · Map Local — 텍스트 바꿔 UI 깨짐 확인

GET /product 는 정상 상품(200)을 내려줍니다. Map Local로 응답의 텍스트를 아주 길게 / 이모지·특수문자 / 빈 값 등으로 바꿔서 줄바꿈·말줄임·레이아웃이 버티는지(=UI가 깨지는지) 확인하세요.

📋 Map Local로 내려줄 응답 보기 (이 값들을 극단적으로 바꿔보세요)

{
  "success": true,
  "data": {
    "name": "황금올리브치킨 세트 (순살)",
    "summary": "바삭한 황금올리브 순살치킨 + 치즈볼 4개 + 콜라 1.25L",
    "price": 23000,
    "originalPrice": 28000,
    "badges": ["베스트", "1+1 이벤트"],
    "rating": 4.7,
    "reviewCount": 1820
  }
}

🔎 깨뜨려볼 케이스

name 을 50자 이상 아주 길게 → 한 줄 말줄임 vs 줄바꿈
badges 를 10개 이상 → 칩이 넘치는지 / 줄바꿈 되는지
summary 에 이모지·특수문자 폭탄 🔥🔥🔥
price 를 음수/엄청 큰 수/문자열로 → 포맷 깨짐
필드를 아예 빼서 → 빈 값/undefined 처리되는지

실습 3 · Map Local — 오류 화면 띄우기

GET /payment 는 기본적으로 결제 성공(200)을 내려줍니다. Map Local로 아래 오류 응답을 내려주면, 서버 장애 없이 오류 UI를 테스트할 수 있습니다.

📋 Map Local로 내려줄 오류 응답 보기 (예: 400)

{
  "success": false,
  "error": {
    "code": "PROXYMAN_INSUFFICIENT_BALANCE",
    "message": "잔액이 부족합니다. 다른 결제수단을 선택해 주세요."
  }
}

실습 4 · Map Local — 명세 먼저 개발

GET /reviews 는 서버 미구현(501)입니다. 아래 JSON을 Map Local 응답으로 그대로 내려주면 서버 없이 UI가 완성됩니다. (필드 명세는 SPEC.md 참고)

📋 Map Local로 내려줄 응답 보기 (200 OK)

{
  "success": true,
  "data": {
    "averageRating": 4.6,
    "totalCount": 3,
    "reviews": [
      {
        "id": 101,
        "author": "치킨러버",
        "rating": 5,
        "content": "바삭하고 양도 많아요. 치즈볼은 항상 진리!",
        "menus": ["황금올리브치킨", "치즈볼"],
        "createdAt": "2026-05-24"
      },
      {
        "id": 102,
        "author": "강남직장인",
        "rating": 4,
        "content": "맛은 좋은데 배달이 살짝 늦었어요. 그래도 따뜻하게 왔습니다.",
        "menus": ["황금올리브치킨"],
        "createdAt": "2026-05-23"
      },
      {
        "id": 103,
        "author": "야식헌터",
        "rating": 5,
        "content": "늦은 밤에 시켰는데 빠르게 왔어요 👍 콜라 시원했음",
        "menus": ["콜라 1.25L"],
        "createdAt": "2026-05-22"
      }
    ]
  }
}

실습 5 · Scripting (User-Agent)

GET /home 응답이 User-Agent에 따라 달라집니다. Proxyman Scripting으로 Request의 User-Agent에 BaeminApp 을 주입하면 APP 응답으로 바뀝니다.

실습 6 · Network Conditions (로딩뷰)

GET /feed 를 부를 때 스켈레톤 로딩뷰가 보입니다. 평소엔 순식간에 지나가지만, Proxyman Network Conditions 로 속도를 낮추면 로딩뷰를 천천히 검증할 수 있습니다.

🔎 Network Conditions 설정 보기

Tools > Network Conditions 활성화
프리셋을 2G / Edge 등 느린 값으로 선택
또는 Latency를 3000ms 이상으로 직접 설정
새로고침 → 스켈레톤이 길게 노출되는지 확인