재시도

네트워크는 재시도하며, 재시도가 두 번째 문서를 만들거나 송장 번호를 하나 더 소모해서는 안 됩니다. 이를 위해 아무것도 할 필요가 없습니다. 지난 10분 안에 보낸 것과 동일한 요청(같은 템플릿, 같은 값, 같은 제목, 같은 키)이 다시 도착하면 첫 요청이 만든 문서를 201 대신 HTTP 200과 replayed: true로 돌려줍니다.

일치 판정은 의도적으로 정확합니다. 제목을 바꾸면 새 문서입니다. 무엇을 같은 요청으로 볼지 직접 정하고 싶다면 그 요청에 고유한 임의의 문자열을 Idempotency-Key 헤더로 보내세요. 키는 24시간 동안 기억되며, 그 키를 가진 재시도는 본문이 무엇이든 같은 문서를 돌려줍니다. 어느 쪽이든 첫 요청이 아직 실행 중일 때 도착한 재시도는 몇 초 기다렸다가 idempotency_in_flight를 돌려줍니다.