요청자 관리번호 지정하기 / 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 응답이 내려가요.Modified at 2025-10-16 06:00:01