API 오류 처리, 재시도, 멱등성 다루기

정상 경로만이 아니라 실패까지 고려해 설계하세요. 가장 위험한 경우는 모호한 상황입니다. 연결이 끊기기 전에 성공했는지 아닌지 알 수 없는 요청이 그렇습니다.

주문 요청에 멱등성 키(idempotency key)를 사용하면, 타임아웃 이후 안전하게 재시도했을 때 중복 청구를 만드는 대신 기존 주문을 반환합니다. 일시적 오류(속도 제한, 일시적인 5xx)는 점점 늘어나는 백오프와 상한을 두고 재시도하세요.

잘못된 요청이나 잔액 부족 같은 영구적 오류는 빠르게 실패 처리하고 사람이 확인할 수 있게 노출하세요. 이런 오류를 재시도하는 것은 시간 낭비일 뿐입니다. 나중에 대조할 수 있도록 모든 요청과 응답을 주문 ID와 함께 기록하세요.