2.3 인증서 신청 상태 조회

2.3.1 API 정보

테스트 환경
리얼 환경	https://portal.racent.com/ssl/collect
요청 방식	POST
content-type	multipart/form-data
설명	이 인터페이스는 주문한 인증서 상태 조회, 인증서 조회, 검증 정보 조회에 사용됩니다.

2.3.2 매개변수 정의

매개변수 이름	매개변수 유형	필수	설명
certId	String	Y	racent 인증서 id
api_token	String	Y	신원 증명 자격 증명으로, token 생성은 Racent 기술 지원에 문의해 주세요.

함수 반환

매개변수 이름	매개변수 유형	필수	설명
code	int	Y	반환 상태이며, 자세한 내용은 부록 3.1을 참고해 주세요
status	String	Y	주문 상태: PENDING:신청 중 COMPLETE:신청 성공 CANCELLED:취소됨 REISSUED:재서명됨 FAILED:신청 실패 RENEWED:갱신됨 REVOKED:폐기됨
certStatus	String	Y	인증서 상태: PENDING:신청 중 COMPLETE:신청 성공 CANCELLED:취소됨 REISSUED:재서명됨 FAILED:신청 실패 RENEWED:갱신됨 REVOKED:폐기됨
data	Object	N	반환 데이터, 아래는 구체적인 세부 정보입니다.
failReason	Object	N	상태가 FAILED인 경우 이 매개변수는 Y이며, 실패 원인입니다.
dataReasons	Array	N	데이터 원인
key	String	N	항목
reason	String	N	원인
sysReason	String	N	시스템 원인
beginDate	String	N	상태가 COMPLETE인 경우 이 매개변수는 Y이며, 인증서 시작 시간입니다.
endDate	String	N	상태가 COMPLETE인 경우 이 매개변수는 Y이며, 인증서 종료 시간입니다.
certificate	String	N	상태가 COMPLETE인 경우 이 매개변수는 Y이며, pem 인증서입니다.
caCertificate	String	N	상태가 COMPLETE일 때 이 파라미터는 Y이며, pem 중간 인증서입니다.
jks	String	N	상태가 COMPLETE이고 Racent에 올바른 개인키 정보가 있을 때 이 파라미터는 Y이며, jks 인증서 내용의 base64 인코딩 값입니다.
jksPass	String	N	상태가 COMPLETE이고 Racent에 올바른 개인키 정보가 있을 때 이 파라미터는 Y이며, jks의 인증서 비밀번호입니다.
pkcs12	String	N	상태가 COMPLETE이고 Racent에 올바른 개인키 정보가 있을 때 이 파라미터는 Y이며, PKCS12 인증서 내용의 base64 인코딩 값입니다.
pkcsPass	String	N	상태가 COMPLETE이고 Racent에 올바른 개인키 정보가 있을 때 이 파라미터는 Y이며, PKCS12의 인증서 비밀번호입니다.
privateKey	String	N	상태가 COMPLETE이고 Racent에 올바른 개인키 정보가 있을 때 이 파라미터는 Y이며, 개인키 정보입니다.
rsaPrivateKey	String	N	rsa 형식 개인키로, 상태가 COMPLETE이고 Racent에 올바른 개인키 정보가 있을 때 이 파라미터는 Y이며, 개인키 정보입니다.
replaceCertId	String	N	상태가 REISSUED일 때 이 파라미터는 Y이며, 재서명 후의 Racent 인증서 id입니다.
oldCertId	String	N	신청한 인증서가 재서명 인증서일 때 이 파라미터는 Y이며, 이전 Racent 인증서 id입니다.
vendorId	String	N	CA 주문 번호
vendorCertId	String	N	CA 인증서 번호(sectigo 주문 번호)
DCVfileName	String	N	도메인 파일 검증, 파일 이름
DCVfileContent	String	N	파일 검증, 파일 내용
DCVdnsHost	String	N	DNS 검증, host
DCVdnsValue	String	N	DNS 검증 value
DCVdnsType	String	N	DNS 검증 type
dcvInfo	Object	N	신청한 인증서의 각 도메인별 검증값이 다를 경우 이 항목은 Y입니다 각 항목의 유형은 Object이며, 각 항목의 객체명은 신청한 도메인입니다(예: racent.com). 각 항목의 세부 정보는 다음과 같습니다.
DCVfileName	String	N	도메인 파일 검증, 파일 이름
DCVfileContent	String	N	파일 검증, 파일 내용
DCVdnsHost	String	N	DNS 검증, host
DCVdnsValue	String	N	DNS 검증 value
DCVdnsType	String	N	DNS 검증 type
DCVfilePath	String	N	파일 검증 파일 경로
dcvList	Array	N	도메인 검증 목록, 각 항목의 유형은 Object이며 각 항목의 세부 정보는 다음과 같습니다:
domainName	String	N	도메인
dcvMethod	String	N	도메인 제어 검증(DCV) 방법
dcvEmail	String	N	도메인 제어 검증(DCV) 이메일
is_verify	String	N	검증 완료 시 매개변수 값은 "verified"이며, 미검증 시 매개변수가 없습니다.
application	Object	N	주문 제출 상태
status	String	N	매개변수는 다음 값 중 하나입니다: notdone: 미완료 done: 완료 ongoing: 진행 중
dcv	Object	N	도메인 제어 검증(DCV) 상태
status	String	N	매개변수는 다음 값 중 하나입니다: notdone: 미완료 done: 완료 ongoing: 진행 중
ov	Object	N	조직 검증 상태
status	String	N	매개변수는 다음 값 중 하나입니다: notdone: 미완료 done: 완료 ongoing: 진행 중
issued	Object	N	발급 상태
status	String	N	매개변수는 다음 값 중 하나입니다: notdone: 미완료 done: 완료 ongoing: 진행 중
applyParams	Object	N	신청 매개변수, 구체적인 내용은 신청 인터페이스(place) 요청 매개변수를 참고하세요.
csr	String	N	csr
Administrator	Object	N	관리자 정보
job	String	N	직책
city	String	N	도시
email	String	N	이메일
state	String	N	성 또는 주
mobile	String	N	연락처
address	String	N	연락 주소
country	String	N	국가(ISO 3166-1 표준의 두 자리 코드).
lastName	String	N	성
postCode	String	N	우편번호
firstName	String	N	이름
organation	String	N	회사명
idType	String	N	증명서 유형. CFCA의 경우 이 항목은 Y입니다. 값은 다음과 같습니다: SFZ: 주민등록증 HZ: 여권
idNumber	String	N	증명서 번호. CFCA의 경우 이 항목은 Y입니다.
tech	Object	N	기술 담당자 정보, 세부 항목은 관리자 정보와 동일합니다.
finance	Object	N	재무 담당자 정보, 세부 항목은 관리자 정보와 동일합니다.
organizationInfo	Object	N	회사 정보
organizationCity	String	N	도시
organizationName	String	N	이름
organizationMobile	String	N	전화
organizationAddress	String	N	주소
organizationCountry	String	N	국가
organizationPostCode	String	N	우편번호
organizationRegNumbe	String	N	회사 증명서 번호. CFCA의 경우 이 항목은 Y입니다.
idType	String	N	회사 증명서 유형. CFCA의 경우 이 항목은 Y입니다. 값은 다음과 같습니다: TYDMZ：통합사회신용코드 OTHERS：기타
errors	Object or String	N	반환 상태가 오류일 때의 구체적인 오류 정보입니다.