Setup 시간 20분에서 30초로 단축한 Zero-Config Mock API 설계

Context

기존 json-server 기반 환경의 반복적인 Local Setup 과정과 CORS 설정 및 Latency 시뮬레이션의 번거로움 발생. 인프라 구축 시간으로 인한 Frontend 개발 생산성 저하 문제 해결 필요.

Technical Solution

• FastAPI와 PostgreSQL 기반의 Serverless-like 구조를 통해 JSON Payload의 즉각적인 API Endpoint화 구현
• Cloudflare의 CF-Connecting-IP 헤더를 활용하여 Docker Bridge IP 문제를 해결한 정확한 Rate Limiting 적용
• Cache-Control 헤더의 엄격한 제어를 통한 Cloudflare Edge Caching 방지로 실시간 Hit Count 정확도 확보
• UUID 기반 Secret Token 방식을 통한 Account-less Management 구조 설계로 가입 절차 제거 및 개인정보 보호 비용 최소화
• HTTP Method, Status Code(100-599), Latency(최대 10s)의 동적 설정을 지원하는 Generic Response Handler 구축

Impact

• API Mocking Setup 시간 20분에서 30초 미만으로 97% 이상 단축
• 가입 및 인증 단계 제거를 통한 Zero-friction 사용자 경험 제공

Key Takeaway

사용자 경험의 마찰(Friction)을 줄이기 위해 관리 편의성을 일부 희생(URL 분실 시 복구 불가)하더라도 핵심 가치인 '즉각성'을 우선시한 실용적 Trade-off 설계 사례