2.21 Изменение заявки

2.21.1 Информация об API

Тестовая среда
Рабочая среда	https://portal.racent.com/ssl/alter
Метод запроса	POST
content-type	multipart/form-data
Описание	Этот интерфейс используется только в случае неудачной подачи заявки на сертификат CFCA для изменения данных заявки.

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

Название параметра	Тип параметра	Обязательный	Описание
api_token	String	Y	Учётные данные, для генерации token обратитесь в техническую поддержку Racent.
certId	String	Y	Идентификатор сертификата Racent
refId	String	N	Уникальный номер заказа клиента, предоставленный клиентом
verificationPic	File	N	Резервные материалы для проверки. Используются для проверки организации, поддерживаются форматы .jpg/.jpeg/.png/.gif/.bmp/.rar/.zip, размер не более 2 МБ.
domainVerificationPic	File	N	Если способ проверки домена — VERIFY_DOCUMENT, этот параметр обязателен (Y). Используется для подтверждения права собственности на домен (в настоящее время поддерживается только CFCA).
params	String	Y	Информация о заказе, подробное описание приведено ниже
csr	String	N	Если параметр пуст, для вас будет сгенерирован CSR, а закрытый ключ сохранён.
privateKey	String	N	Закрытый ключ.
server	String	N	Сервер. Относится только к SSL-сертификатам. Для SSL-сертификатов параметр — Y, для продуктов других типов — N. Если этот параметр не нужен, по умолчанию используйте «other».
orgCheck	Int	N	Значение 0 или 1. Если значение равно 1, будет выполнен поиск всех организаций в вашей учетной записи на основе предоставленной информации об организации. Если организация существует, будут использованы связанные с ней данные; если не существует, она будет сохранена как новая. Если значение равно 0, информация об организации не сохраняется.
duplicateOrgCheck	Int	N	Значение 0 или 1. В настоящее время этот параметр относится только к SSL-сертификатам Digicert. Используется для определения, следует ли повторно использовать ранее проверенную информацию об организации и домене. При значении 1 — повторное использование. При значении 0 — создание новой. По умолчанию — 1.
dcvMethod	String	N	Единая настройка способа проверки домена для заявки. Должен быть одним из следующих четырех способов: EMAIL (проверка по 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	Почтовый индекс местонахождения компании.
organizationRegNumbe	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-сертификатов. Информация о техническом специалисте. Обязательный параметр (Y), если заказываемый продукт не типа dv. { "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	Если возвращается статус ошибки — конкретное сообщение об ошибке.
data	Object	N	Если возвращается статус успеха — этот параметр имеет значение Y. Подробное описание ниже:
certId	String	N	Идентификатор сертификата racent. Пожалуйста, храните его надёжно: этот параметр является уникальным идентификатором экземпляра racent.
vendorId	String	N	Номер заказа CA.
vendorCertId	String	N	Номер сертификата CA.
DCVfileName	String	N	Имя файла для проверки файла
DCVfileContent	String	N	Содержимое файла для проверки файла
DCVdnsHost	String	N	Значение хоста для проверки DNS
DCVdnsValue	String	N	Значение записи для проверки DNS
DCVdnsType	String	N	Тип записи для проверки DNS
DCVfilePath	String	N	Путь к файлу для проверки файла
dcvInfo	Object	N	Если значения проверки для каждого домена в заявке на сертификат различаются — этот параметр имеет значение Y Каждый элемент имеет тип Object, имя объекта — это заявленный домен, например: racent.com. Подробное описание каждого элемента ниже:
DCVfileName	String	N	Содержимое файла для проверки файла
DCVfileContent	String	N	Содержимое файла для проверки файла
DCVdnsHost	String	N	Значение хоста для DNS-проверки
DCVdnsValue	String	N	Значение записи DNS-проверки
DCVdnsType	String	N	Тип записи DNS-проверки
DCVfilePath	String	N	Путь к файлу для проверки файла
failReason	Object	N	Возвращается, когда запрос сертификата в CA через Racent завершился неудачей и причина сбоя была точно установлена.
dataReasons	Array	N	Причины, связанные с данными
key	String	N	Элемент
reason	String	N	Причина
sysReason	String	N	Системная причина