API Versioning이란?
"v1에 의존하는 클라이언트는 깨지지 않으면서 v2를 추가"하는 방식이다.
방식
- URL — /v1/users (가장 흔함)
- Header — Accept: application/vnd.api.v2+json
- Query — ?version=2
Stripe 방식
날짜 기반 버저닝 (2025-01-01) — 매우 세밀.
API Versioning란?
정의
API 변경 시 기존 클라이언트 호환성을 유지하는 전략. URL·헤더·쿼리 방식.
🔗 함께 보면 좋은 용어
Backend 전체 →실시간 옵션 비교
폴링·Long Polling·SSE·WebSocket. 복잡도·기능별 선택.
A/B Testing
두 변형을 무작위 분할해 비교하는 실험 방법론. Feature Flag와 자주 결합.
Access + Refresh Flow
짧은 Access Token과 긴 Refresh Token을 조합한 인증 패턴. 보안과 UX 균형.
Actix Web
Rust의 고성능 웹 프레임워크. 타이프 세이프·액터 모델.
API
Application Programming Interface
소프트웨어 간 통신 약속. 보통 HTTP 기반 REST, GraphQL, gRPC가 대표적.
API Gateway
클라이언트와 백엔드 서비스들 사이의 단일 진입점. 인증·레이트 리밋·라우팅·로깅을 중앙화.