IOSOR 가이드
파일럿에서 프로덕션까지 API 속도 제한: prepaid 를 태우지 않는 백오프
파일럿과 프로덕션 한도, 지수 백오프, 멱등, 샌드박스 대 프로덕션 키, 유계 webhook 리플레이 창 — 재시도가 prepaid 지갑을 비우지 않게.
429 는 보내기 API 를 통과할 때까지 두드리라는 초대가 아니다. Prepaid 에서 재시도 폭풍은 지갑 사건이다. 중복 OTP, 쌓인 알림, 맞지 않는 원장 줄. 한도는 제품·엔지니어링·재무가 하나의 천장을 나누도록 있다. 파일럿에서 프로덕션은 «캡을 제거»가 아니다. 계약 한도, 멱등을 지키는 백오프, 나뉜 샌드박스와 프로덕션 키, 두 번 차변하지 않는 webhook 리플레이 창. 멱등, 재시도와 자금 를 보라.
IOSOR 는 white-label prepaid 다. 인증 호출, 맞출 수 있는 차변, 다른 브랜드 페이로드를 쏟지 않는 고객 안전 오류. live / in setup 은 재시도 세기와 독립 — 복도가 in setup 이면 클라이언트가 루프해도 Live 가 되지 않는다. 월 USD 1,000+ 근처에서 재시도 예산과 키 전환이 상업 리뷰에 들어간다. 같은 런북에 샌드박스에서 프로덕션으로 전환 와 웹훅 서명과 리플레이 창.
한도는 prepaid 를 지키며 버그가 아니다
한도는 창마다 몇 개의 수락된 의도가 지갑에 닿는지를 묶는다. 로드 밸런서의 TCP 시도 수가 아니다. 창(키·계정·목적지 클래스), 상태 코드, Retry-After 를 문서화하라. 429 를 «더 세게»로 읽는 클라이언트는 재무와 경주한다. 한도 거부를 성공 차변 옆에 내보내라. 카탈로그 live 여도 공표 천장에서 멈춘다. in setup 은 무한 샌드박스가 아니다.
| 신호 | 엔지니어링 | 지갑 |
|---|---|---|
| 429 / Retry-After | 백오프하고 창을 지켜라 | 같은 의도의 추가 차변 제로 |
| 5xx / 타임아웃 | 같은 멱등 키로 예산 안 재시도 | 첫 시도가 착지했으면 한 차변 |
| 4xx 업무 거부 | 맹목적으로 재시도하지 마라 | 차변 없음, 또는 이름 있는 거부 줄 |
두 번째 차변 없는 백오프: 한도와 멱등
멱등 키 없는 지수 백오프는 흔들리는 망을 두 OTP 로 만든다. 키는 업무 의도마다 유일하며 TCP 시도마다가 아니고, 분명한 TTL 안에서 같은 수락 결과를 돌려준다. 사용자 재전송은 자체 한도를 가진 다른 제품 동작이다. 낮은 잔액 정지는 적용된다. 재시도가 빈 지갑을 뚫으면 안 된다.
파일럿 한도 대 프로덕션 한도
파일럿 키는 더 조여야 한다. 낮은 양, 빠른 가시성, 싼 실수. 프로덕션 한도는 실제로 돌리는 복도에 계약한다. 천장을 올리는 것은 책임자 있는 계정 변경이다. 부하 시험은 샌드박스 키. 프로덕션 키의 소크는 prepaid 연소다. 카탈로그 복도가 in setup 인 동안 프로덕션 QPS 를 약속하지 마라.
키와 webhook 리플레이는 같은 전환
보내기 한도는 webhook 소비자가 DLR 을 두 번 처리하면 구하지 못한다. 전환: 샌드박스 트래픽을 얼리고, 프로덕션 키를 발급하고, webhook 을 프로덕션 소비자로 향하게 하고, 서명을 검증하고, 리플레이 창을 묶은 뒤 실제 의도 하나. 02:00 의 재콜백은 no-op 이지 두 번째 차변이 아니다. 비밀은 나눈다. 티켓에 붙이지 마라.
위험 신호
- 멱등 키 없이 «200 까지 재시도»
- 429 를 부드러운 200 으로 취급
- 부하 시험의 프로덕션 키, 또는 프로덕션의 샌드박스 webhook URL
- 주 단위 리플레이 창, 또는 «파일럿용» 미소명 콜백
- 자동 재시도 예산에 섞인 사용자 재전송
- 상류 생코드를 쏟는 고객 대면 오류
IOSOR로 시작
한도 창을 적어라. 키, 계정, 목적지 등급마다. 지킬 Retry-After 도 적어라. 429 를 강제하고 백오프한 뒤 같은 Idempotency-Key 로 같은 의도를 다시 보낸다. ledger 는 debit 하나여야 한다. 천장을 올리기 전에 샌드박스 키를 프로덕션 키로 바꿔라.
IOSOR 핵심 요약
할 일: 429 를 Retry-After 가 있는 정지로 보고, 부드러운 성공으로 보지 마라. 모든 백오프에 원래 키를 붙여 prepaid 가 수락된 의도 하나만 보게 하라.
하지 말 일: 부하 시험 키로 프로덕션 한도를 올리거나, 키 없이 200 까지 두드려 지갑을 여분 사용처럼 만들지 마라.
이 가이드가 도움이 되었나요?
관련 가이드
- 로컬 테스트에서 DLR 지연 및 오류 시뮬레이션하기
CPaaS 통합을 승격하기 전에 비동기 전달 영수증을 모의 처리하고, DLR 지연을 관리하며, 로컬에서 엣지 케이스를 테스트하는 방법을 학습합니다.
- 페이로드 일괄 처리와 단일 요청 처리량의 균형 유지
화이트라벨 CPaaS 콘솔에서 속도 제한 준수를 유지하면서 대용량 알림 발송을 위한 API 동시성 전략을 최적화합니다.
- 플랫폼 보안을 위한 멀티 테넌트 API 키 범위 지정
API 토큰 범위를 지정하여 테넌트 트래픽을 격리하고, 크로스 계정 메시지 유출을 방지하며, 재정적 한도를 시행하여 화이트라벨 CPaaS 하위 계정을 보호합니다.