API 인시던트 주간: 누락된 멱등성은 재시도 폭풍이 아니라 동결입니다

API 인시던트 주간: 누락된 멱등성은 재시도 폭풍이 아니라 동결입니다。

자정의 경고와 회선의 침묵

대시보드에는 인바운드 SMS 트래픽이 급증하는 동안 DLR 전달의 평탄선이 표시됩니다. 하류 네트워크 파티션이 요청 중에 TCP 패킷을 드롭했고 클라이언트의 마이크로서비스는 실패로 간주했습니다. 적절한 안전장치가 없으면 자동화된 클라이언트는 동일한 페이로드로 게이트웨이를 공격하기 시작합니다. 모든 중복 요청이 잔액을 이중 차감할 위험이 있는 선불 원장에 대한 전형적인 재시도 폭풍을 보고 있습니다. 화이트라벨 선불 CPaaS 모델에서 첫 번째 API 인시던트는 가동 시간뿐만 아니라 연쇄적인 네트워크 장애로부터 클라이언트 자금을 보호하는 것입니다.

안전장치 없는 재시도가 선불 잔액을 소모하는 이유

클라이언트 시간 초과가 발생하면 단순한 애플리케이션 로직이 즉시 HTTP 요청을 재전송합니다. 라우팅 계층이 이러한 중복을 독립적으로 처리하는 경우, 각 API 히트는 새로운 JIT 번호 할당 또는 새로운 SMS 발송을 트리거합니다. 이는 리스크 엔진이 따라잡기 전에 잔액을 0 미만으로 떨어뜨려 USD 20 선불 하한 로직을 위반합니다. 희망이나 클라이언트 측의 약속에 의존할 수 없습니다. 멱등, 재시도와 자금 에 대한 가이드를 검토하여 재연결 시 트랜잭션 잠금이 지갑의 우연한 배출을 방지하는 방법을 이해하십시오.

장애 격리 및 루프 중지

즉각적인 운영 우선순위는 코드를 패치하기 전에 인바운드 트래픽을 중단하는 것입니다. API Gateway 에지에 긴급 속도 제한 규칙을 구현하여 좁은 시간 창 내에 도착하는 동일한 페이로드를 드롭합니다. 원장 상태가 경합하는 동안 트랜잭션을 처리하려고 하지 마십시오. 플랫폼이 분쟁 트래픽 볼륨에서 월 USD 1,000 부근의 소프트 검토 임계값에 가까워지면 업스트림 통신사는 의심스러운 변동성에 대해 판매자 ID에 플래그를 지정합니다. 관리 콘솔을 통해 영향을 받는 클라이언트 엔드포인트를 즉시 동결하십시오.

트랜잭션 상태 및 원장 일관성 검증

폭풍이 가라앉으면 인시던트 창 동안 이루어진 모든 잔액 조정을 감사해야 합니다. 내부 원장 로그를 통신사 HB 신호와 비교하여 SMS가 발송되었지만 DLR 전달 로깅에 실패한 고아 요청을 식별합니다. 개발자는 단일 스레드 데이터베이스 제약 조건만으로 충분하다고 가정하여 API 두 번째 달: 첫 번째 주기가 지난 후 멱등성 부채 관리 를 범하기 쉽습니다. 그렇지 않습니다. 분산 마이크로서비스는 동일한 API 서명이 단일 상태 시스템 실행으로 해결되도록 명시적인 해시 기반 요청 잠금이 필요합니다.

에코 재생에 대한 웹훅 전달 보안

인시던트 중 아웃바운드 API 호출을 관리하는 것만큼 인바운드 웹훅을 안전하게 처리하는 것도 중요합니다. 데이터베이스 잠금 경합으로 인해 서버가 5xx 오류를 반환하는 경우 비동기 DLR 업데이트를 처리하는 클라이언트도 무한 루프에 빠질 수 있습니다. 300초보다 오래된 오래된 페이로드를 폐기하기 위해 암호화 타임스탬프를 사용하는 엄격한 웹훅 서명과 리플레이 창 검사를 구현하십시오. 이를 통해 자동화된 시스템이 오래된 전달 영수증으로 하위 엔드포인트를 공격하는 것을 방지합니다.

탄력적인 트랜잭션 제어를 위해 IOSOR로 시작

사고 주에는 먼저 새 발신을 멈춘다. 비행 중인 전송마다 Idempotency-Key 를 달고, 중복 debit 행을 보내고, 조용한 클라이언트 재시도를 끈다. 따라잡으려 재시도 폭풍을 열지 마라.

IOSOR 핵심 요약

할 일: 빠진 키는 동결로 보고 나서 채우고 ledger 를 맞춘다.

하지 말 일: 중복 DLR 이 아직 두 번째 debit 를 찍는데 사고를 닫지 마라. 티켓 상태는 돈 상태가 아니다.