본문으로 건너뛰기

2.1 데이터 검증

2.1.1 인터페이스 설명​

테스트 환경
실제 환경https://portal.racent.com/ssl/validate
요청 방식POST
content-typemultipart/form-data
설명이 인터페이스는 전달하신 모든 주문 데이터를 검증하는 데 사용됩니다. 주문 인터페이스를 호출하기 전에 이 인터페이스를 호출하여 원활한 주문 처리를 보장하십시오. 이 검증은 계정 정보를 확인하고 주문 정보에 오류가 없는지 확인하며, 관련 오류 코드를 반환합니다(부록 3.1 참조).

2.1.2 매개변수 정의​

매개변수 이름매개변수 유형필수설명
api_tokenStringY사용자 토큰. 토큰 발급은 Racent 기술 지원에 문의하십시오.
productCodeStringY제품 코드. 제품 코드 획득(2.7 참조)
yearsIntY구매 연한(현재 1, 2, 3, 4, 5만 지원), 구체적인 제품에 따라 다릅니다.
refIdStringN고객이 제공한 유일한 고객 주문 번호
verificationPicFileN예비 검증 자료. 조직 검증에 사용되며 .jpg/.jpeg/.png/.gif/.bmp/.rar/.zip/.pdf 형식을 지원하며 내용은 2M를 초과할 수 없습니다.
domainVerificationPicFileN도메인 검증 방식이 VERIFY_DOCUMENT인 경우 이 항목은 Y입니다. 도메인 제어 검증(DCV)에 사용됩니다(현재 CFCA만 지원).
paramsStringY주문 정보(json 문자열), 구체적인 설명은 다음과 같습니다
csrStringN매개변수가 비어 있으면 CSR을 생성하고 개인 키를 저장합니다.
privateKeyStringN개인 키.
serverStringN서버. SSL 인증서에만 해당됩니다. SSL 인증서 매개변수는 Y이고, 다른 유형의 제품 매개변수는 N입니다. 이 매개변수가 필요하지 않으면 기본값으로 “other”를 사용하세요.
uniqueValueStringNSectigo 제품에만 해당됩니다. 1~20자(a-z A-Z 0-9)로 리셀러가 검증 값을 직접 생성하는 데 사용됩니다.
dcvMethodStringN신청 도메인 검증 방식을 통일하여 설정합니다.
반드시 다음 네 가지 방식 중 하나여야 합니다.
EMAIL(이메일 검증)
HTTP_CSR_HASH(파일 검증)
CNAME_CSR_HASH(DNS 검증)
HTTPS_CSR_HASH(https 파일 검증)
VERIFY_DOCUMENT(도메인 인증서 증명, CFCA만 지원)
CFCA의 경우 Y입니다
domainInfoStringN도메인 정보. SSL 인증서와만 관련됩니다. SSL 인증서 매개변수는 Y이고, 기타 유형 매개변수는 N입니다.
예시:
[
{ "dcvEmail": "admin@xxx.com",
"dcvMethod": "EMAIL",
"domainName": "www.xxx.com"
},
{
"dcvEmail": "admin@aaa.com",
"dcvMethod": "EMAIL",
"domainName": "aaa.com"
},
"dcvEmail": "admin@racent.com",
"dcvMethod": "EMAIL",
"domainName": "racent.com"
}
]
구체적인 설명은 다음과 같습니다:
dcvMethodStringN도메인 검증 방식입니다.
반드시 다음 네 가지 방식 중 하나여야 합니다:
EMAIL(이메일 검증)
HTTP_CSR_HASH(파일 검증)
CNAME_CSR_HASH(DNS 검증)
HTTPS_CSR_HASH(https 파일 검증)
상위 dcvMethod가 존재하지 않으면 이 항목은 Y입니다.
상위 dcvMethod가 존재하고 이 항목도 존재하면 상위 dcvMethod가 우선 사용됩니다.
dcvEmailStringN도메인 검증 이메일.
해당 항목이 N인 경우, 기본값은 다음과 같습니다.
racent.com : admin@racent.com
www.racent.com : admin@racent.com
*.racent.com : admin@racent.com
domainNameStringN도메인
organizationInfoStringN회사 정보. 기업 검증이 필요한 제품을 주문하는 경우, 이 파라미터는 Y입니다. 예시는 다음과 같습니다:
{
"organizationCity": "상하이",
"organizationName": "某회사",
"organizationMobile": "18111111111",
"organizationAddress": "상하이시 로",
"organizationCountry": "CN",
"organizationPostCode": "401320"
}"
organizationCityStringN회사 소재 도시.
organizationNameStringN회사 이름.
organizationMobileStringN회사 전화번호.
organizationAddressStringN회사 주소.
organizationCountryStringN회사 소재 국가(ISO 3166-1 표준의 2자리 코드).
organizationPostCodeStringN회사 소재지 우편번호.
organizationRegNumberStringN회사 등록 번호. CFCA의 경우 Y입니다.
idTypeStringN회사 등록 유형. CFCA의 경우 Y입니다.
값은 다음과 같습니다.
TYDMZ: 통일사회신용코드
OTHERS: 기타
AdministratorstringY관리자 정보, 연락처. 코드 서명, 이메일 서명, 문서 서명을 신청할 때 이 매개변수가 신청 정보로 사용됩니다. 또한 csr이 N인 경우 이 정보는 csr 생성 정보로 사용됩니다.
{
"job": "총괄부서",
"city": "상하이시",
"email": "xx@yy.com",
"state": "상하이시",
"mobile": "18111111111",
"address": "상하이시",
"country": "CN",
"lastName": "zhang",
"postCode": "401320",
"firstName": "nick",
"organation": "모회사"
}"
jobStringY관리자 직위.
cityStringY관리자 소재 도시.
emailStringY관리자 이메일.
stateStringY관리자가 위치한 성 또는 주.
mobileStringY관리자 연락처.
addressStringY관리자 연락 주소.
countryStringY관리자가 위치한 국가(ISO 3166-1 표준의 두 자리 코드).
lastNameStringY관리자의 성.
postCodeStringY관리자 소재지 우편번호.
firstNameStringY관리자 이름.
organationStringY관리자 회사 이름.
idTypeStringN증명서 유형. CFCA의 경우 이 항목은 Y입니다.
값은 다음과 같습니다:
SFZ: 신분증
HZ: 여권
idNumberStringN증명서 번호. CFCA의 경우 이 항목은 Y입니다.
financestringSSL 인증서에만 해당합니다.
재무 담당자 정보. 관리자 정보와 동일할 수 있습니다. 주문 제품이 dv 유형이 아닌 경우 이 매개변수는 Y입니다.
{
"job": "재무부",
"city": "상하이시",
"email": "xx@yy.com",
"state": "상하이시",
"mobile": "18111111111",
"address": "상하이시",
"country": "CN",
"lastName": "zhang",
"postCode": "401320",
"firstName": "nick",
"organation": "모회사"
}"
jobStringN재무 담당자 직위.
cityStringN재무 담당자가 위치한 도시.
emailStringN재무 담당자의 이메일.
stateStringN재무 담당자가 속한 성 또는 주.
mobileStringN재무 담당자 연락처.
addressStringN재무 담당자 연락 주소.
countryStringN재무 담당자의 국가(ISO 3166-1 표준의 2자리 코드).
lastNameStringN재무 담당자의 성.
postCodeStringN재무 담당자 소재지 우편번호.
firstNameStringN재무 담당자 이름.
organationStringN재무 담당자 소속 회사.
idTypeStringN증명서 유형. CFCA의 이 항목은 Y입니다.
값은 다음과 같습니다:
SFZ: 주민등록증
HZ: 여권
idNumberStringN증명서 번호. CFCA의 경우 Y입니다.
techstringNSSL 인증서에만 해당됩니다.
기술 담당자 정보. 주문 제품이 dv 유형이 아닌 경우 이 매개변수는 Y입니다.
{
"job": "기술부", "city": "상하이시",
"email": "xx@yy.com",
"state": "상하이시",
"mobile": "18111111111",
"address": "상하이시",
"country": "CN",
"lastName": "zhang",
"postCode": "401320",
"firstName": "nick",
"organation": "모회사"
}"
jobStringN기술 담당자 직위.
cityStringN기술원이 위치한 도시.
emailStringN기술원의 이메일.
stateStringN기술원이 위치한 성 또는 주.
mobileStringN기술자 연락처.
addressStringN기술자 연락 주소.
countryStringN기술자 소재 국가(ISO 3166-1 표준의 두 자리 코드).
lastNameStringN기술자 성.
postCodeStringN기술자 소재지 우편번호.
firstNameStringN기술자 이름.
organationStringN기술자가 소속된 회사입니다.
idTypeStringN증명서 유형입니다. CFCA의 경우 이 항목은 Y입니다.
값은 다음과 같습니다.
SFZ: 신분증
HZ: 여권
idNumberStringN증명서 번호입니다. CFCA의 경우 이 항목은 Y입니다.

함수 반환​

매개변수 이름매개변수 유형필수설명
codeIntY반환 상태이며, 자세한 설명은 부록 3.1을 참조하십시오.
errorsObject or StringN반환 상태가 오류일 경우 오류 정보입니다.

2.1.3 요청 예시​

请求示例

{
	"years": 2,
	"params": ‘{"server":"iis7","csr":"-----BEGIN CERTIFICATE REQUEST-----\nxxxxxxyyyoo\n-----END CERTIFICATE REQUEST-----\n","domainInfo":[{"domainName":"tt.cn","dcvMethod":"HTTP_CSR_HASH","dcvEmail":""}],"Administrator":{"organation":"cola","job":"it","firstName":"nick","lastName":"zhang","email":"xx@tt.com.cn","mobile":"13911111111","country":"CN","address":"上海市","city":"上海","state":"上海","postCode":"4457145"},"finance":{"organation":"某公司","job":"ceo","firstName":"nick","lastName":"zhang","email":"xxx@qq.com","mobile":"18111111111","country":"CN","address":"上海市","city":"上海","state":"上海","postCode":"4514154"},"tech":{"organation":"某公司","job":"ceo","firstName":"nick","lastName":"zhang","email":"xxx@qq.com","mobile":"15122222222","country":"CN","address":"上海市","city":"上海","state":"上海","postCode":"48787"},"organizationInfo":{"organizationCity":"上海","organizationState":"上海","organizationMobile":"153999999999","organizationAddress":"上海某地","organizationCountry":"CN","organizationPostCode":"200233","organizationName":"个人"}}’,
	"api_token": "zzzoooppzz",
	"productCode": "comodo-positivessl"
}

최종 수정: 에