사전 준비: 리다이렉트 URL 설정
리다이렉트 URL은 API 키 단위로 설정합니다. 따로 지정하지 않으면 기본값https://bolta.io/openapi-certificate-redirect을 사용하며, 개발자센터의 API 키 수정 화면에서 원하는 주소로 변경할 수 있어요. 리다이렉트 URL은 직접 운영하는 HTTPS 주소로 지정하세요.
설정 방법은 API 키와 웹훅 연결하기를 참고하세요.
등록 흐름
인증서 등록 URL 발급
인증서 등록 URL 조회 API의 경로에
issuerId를 넣어 등록 URL을 발급받습니다. 발급된 URL은 5분간 유효하며, 만료되면 다시 발급받으세요.발급자 인증서 등록
발급자가 URL에 접속해 인증서를 선택하고 비밀번호를 입력합니다.
리다이렉트 복귀
등록이 끝나면 발급자의 브라우저가 API 키에 설정한 리다이렉트 URL로 이동합니다.
등록 결과 확인
인증서 등록 내역 조회 API를 호출해 응답의
latestHistory.code와 latestHistory.message로 등록 성공 여부를 확인합니다. 이 내역은 등록 후 30초 이내에만 조회할 수 있으므로, 리다이렉트로 복귀한 직후에 호출하세요.latestHistory가 null이면 조회 가능한 등록 내역이 없는 상태로 처리하세요.
등록 결과 코드
인증서 등록 내역 조회 API 응답의latestHistory.code와 latestHistory.message 값입니다.