2.1 Проверка данных

2.1.1 Описание интерфейса

Тестовая среда
Рабочая среда	https://portal.racent.com/ssl/validate
Метод запроса	POST
content-type	multipart/form-data
Описание	Этот интерфейс используется для проверки всех переданных вами данных заказа. Пожалуйста, вызывайте этот интерфейс перед вызовом интерфейса оформления заказа, чтобы обеспечить успешную обработку заказа. Данная проверка используется для подтверждения информации о вашей учетной записи, а также для того, чтобы убедиться в корректности информации о вашем заказе, и возвращает соответствующие коды ошибок (см. Приложение 3.1).

2.1.2 Определение параметров

Название параметра	Тип параметра	Обязательный	Описание
api_token	String	Y	Токен пользователя; для получения токена обратитесь в техническую поддержку Racent
productCode	String	Y	Код продукта; получение кода продукта (см. 2.7)
years	Int	Y	Срок действия в годах (в настоящее время поддерживаются только 1, 2, 3, 4, 5), зависит от конкретного продукта.
refId	String	N	Уникальный номер заказа клиента, предоставленный клиентом
verificationPic	File	N	Резервные материалы для проверки. Используются для проверки организации, поддерживаются форматы .jpg/.jpeg/.png/.gif/.bmp/.rar/.zip/.pdf, размер не более 2 МБ.
domainVerificationPic	File	N	Когда метод проверки домена — VERIFY_DOCUMENT, этот параметр обязателен (Y). Используется для проверки права собственности на домен (в настоящее время поддерживается только CFCA).
params	String	Y	Информация о заказе (строка JSON), подробное описание ниже
csr	String	N	Если параметр пустой, CSR будет сгенерирован для вас, а закрытый ключ сохранён.
privateKey	String	N	Закрытый ключ.
server	String	N	Сервер. Относится только к SSL-сертификатам. Для параметров SSL-сертификата значение Y, для параметров продуктов других типов — N. Если этот параметр не нужен, по умолчанию укажите «other».
uniqueValue	String	N	Относится только к продуктам Sectigo. 1–20 символов (a-z A-Z 0-9), используется дистрибьютором для самостоятельной генерации проверочного значения.
dcvMethod	String	N	Единая настройка способа проверки домена заявки. Должен быть одним из следующих четырёх способов: EMAIL (проверка по электронной почте) HTTP_CSR_HASH (проверка файлом) CNAME_CSR_HASH (проверка DNS) HTTPS_CSR_HASH (проверка https-файлом) VERIFY_DOCUMENT (подтверждение сертификатом домена, поддерживается только CFCA) Для CFCA этот параметр — Y
domainInfo	String	N	Информация о домене, относится только к 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" } ] Подробное описание приведено ниже:
dcvMethod	String	N	Способ подтверждения домена. Должен быть одним из четырёх вариантов: EMAIL (подтверждение по электронной почте) HTTP_CSR_HASH (подтверждение файлом) CNAME_CSR_HASH (подтверждение DNS) HTTPS_CSR_HASH (подтверждение HTTPS-файлом) Если родительский dcvMethod отсутствует, этот параметр обязателен (Y). Если родительский dcvMethod указан и этот параметр также указан, приоритет будет у родительского dcvMethod.
dcvEmail	String	N	Электронная почта для проверки домена. Если значение N, по умолчанию используется следующее: racent.com : admin@racent.com www.racent.com : admin@racent.com *.racent.com : admin@racent.com
domainName	String	N	Домен
organizationInfo	String	N	Информация о компании. Если заказывается продукт с проверкой предприятия, этот параметр — Y. Пример: { "organizationCity": "上海", "organizationName": "某公司", "organizationMobile": "18111111111", "organizationAddress": "上海市路", "organizationCountry": "CN", "organizationPostCode": "401320" }"
organizationCity	String	N	Город, в котором находится компания.
organizationName	String	N	Название компании.
organizationMobile	String	N	Телефон компании.
organizationAddress	String	N	Адрес компании.
organizationCountry	String	N	Страна компании (двухбуквенный код по стандарту ISO 3166-1).
organizationPostCode	String	N	Почтовый индекс по месту нахождения компании.
organizationRegNumber	String	N	Регистрационный номер компании. Для CFCA это поле — Y.
idType	String	N	Тип удостоверения компании. Для CFCA это поле — Y. Возможные значения: TYDMZ: единый код общественной кредитоспособности OTHERS: прочее
Administrator	string	Y	Информация об администраторе, контактное лицо. При подаче заявки на подпись кода, подпись электронной почты, подпись документа этот параметр используется как информация заявки. Кроме того, если csr — N, эта информация используется для генерации csr. { "job": "总经办", "city": "上海市", "email": "xx@yy.com", "state": "上海市", "mobile": "18111111111", "address": "上海市", "country": "CN", "lastName": "zhang", "postCode": "401320", "firstName": "nick", "organation": "某公司" }"
job	String	Y	Должность администратора.
city	String	Y	Город администратора.
email	String	Y	Электронная почта администратора.
state	String	Y	Провинция или штат администратора.
mobile	String	Y	Контактный телефон администратора.
address	String	Y	Контактный адрес администратора.
country	String	Y	Страна администратора (двухбуквенный код по стандарту ISO 3166-1).
lastName	String	Y	Фамилия администратора.
postCode	String	Y	Почтовый индекс администратора.
firstName	String	Y	Имя администратора.
organation	String	Y	Название компании администратора.
idType	String	N	Тип удостоверения личности. Для CFCA это поле обязательно (Y). Возможные значения: SFZ：удостоверение личности HZ：паспорт
idNumber	String	N	Номер удостоверения личности. Для CFCA это поле — Y.
finance	string		Только для SSL-сертификатов. Информация о финансовом сотруднике. Может совпадать с информацией администратора. Если заказываемый продукт не типа DV, это поле — Y. { "job": "财务部", "city": "上海市", "email": "xx@yy.com", "state": "上海市", "mobile": "18111111111", "address": "上海市", "country": "CN", "lastName": "zhang", "postCode": "401320", "firstName": "nick", "organation": "某公司" }"
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	string	N	Относится только к SSL-сертификатам. Информация о техническом специалисте. Если заказываемый продукт не типа dv, этот параметр — Y. { "job": "技术部","city": "上海市", "email": "xx@yy.com", "state": "上海市", "mobile": "18111111111", "address": "上海市", "country": "CN", "lastName": "zhang", "postCode": "401320", "firstName": "nick", "organation": "某公司" }"
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.

Возвращаемое значение функции

Имя параметра	Тип параметра	Обязательный	Описание
code	Int	Y	Статус возврата. Подробное описание см. в приложении 3.1
errors	Object or String	N	При возврате статуса ошибки — сообщение об ошибке.

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"
}