요청자 관리번호 지정하기 / Client-Reference-Id

요청자 관리번호는 왜 사용되나요?

각 요청을 처리하는데 있어서 볼타에서 채번하는 관리번호가 있어요. 하지만, 이 관리번호는 요청이 정상적으로 접수·처리되어야만 얻을 수 있는 값이에요.

외부 API를 호출한다고 하면 다양한 상황이 발생할 수 있어요. 대표적으로는 네트워크 오류로 타임아웃이 발생하는 경우가 있을 수 있어요. 이 경우에는 해당 요청이 실패했다고 확신하기 어려워요. 이 상황에서 요청을 한번 더 보내면 요청이 중복으로 처리될 수 있는거죠.

이런 경우, 즉 나의 요청이 고유하게 처리되게 하기 위하여 사용하는게 요청자 관리번호에요.

요청 관리번호는 어떻게 사용하나요?

현재는 아래 API에 대하여 요청자 관리번호를 지원하고 있어요.

전자(세금)계산서 정발행

전자(세금)계산서 수정발행 - 계약의 해제

전자(세금)계산서 수정발행 - 공급가액 변동

위 API를 호출하실 때, HTTP Request Header에 아래 값을 전달하시면 돼요.

...
Bolta-Client-Reference-Id: ABC_123
...

Client-Reference-Id는 API Key 단위로 고유해요. 동일한 API Key에서 같은 Client-Reference-Id 값을 전달하면 HTTP Status Code 400 응답이 내려가요.

요청자 관리번호 지정하기 / Client-Reference-Id

요청자 관리번호는 왜 사용되나요?#

요청 관리번호는 어떻게 사용하나요?#

요청자 관리번호는 왜 사용되나요?

요청 관리번호는 어떻게 사용하나요?