결제 버튼을 두 번 눌렀을 때: 멱등 키의 수명
사용자가 결제 버튼을 다시 눌렀을 때 네트워크는 두 요청을 보낼 수 있습니다. 화면에서 버튼을 비활성화해도 모바일 재전송이나 프록시 재시도가 남습니다. 멱등 키는 같은 의도를 같은 결과로 처리하게 하지만 수명과 범위를 잘못 정하면 다른 요청까지 묶을 수 있습니다.
NOTES
API 설계
모델을 만들고, 웹과 앱을 짓고, 업무를 자동화하며 확인한 것을 기록합니다. 통한 방법만이 아니라 통하지 않았던 시도까지 남깁니다.
TOTAL 5 · API 설계
오래된 API를 언제 끌 수 있을까: 사용량 기반 종료 공지와 전환
API 종료 날짜를 알리는 데서 끝내지 않고 실제 사용 고객을 찾아 전환·검증하는 절차를 정리합니다.
연동 테스트가 실제 고객 데이터를 바꾼다면: API 샌드박스와 운영 분리
파트너 연동에서 테스트 키와 운영 키만 나누면 충분할까요? 가짜 데이터, 이벤트 재현, 권한 경계, 전환 체크리스트까지 설계해야 합니다.
API 오류를 ‘에러 발생’으로 끝내지 않으려면: RFC 9457 오류 계약 설계
같은 실패가 화면에는 막연한 경고, 로그에는 다른 코드로 남으면 대응이 어렵습니다. 상태 코드와 오류 유형, 해결 행동을 연결하는 API 오류 계약을 설명합니다.
API를 바꿔도 서비스는 멈추지 않게: 하위 호환성과 스키마 진화
서버를 업데이트해도 모바일 앱과 외부 고객은 즉시 바뀌지 않습니다. 안전한 필드 추가·삭제, 이벤트 스키마, 소비자 계약 테스트, 버전 전략과 Expand–Migrate–Contract 배포 순서를 정리합니다.