2.10 Продление SSL-подписки

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

Тестовая среда
Рабочая среда	https://portal.racent.com/ssl/renew
Метод запроса	POST
content-type	multipart/form-data
Описание	Этот интерфейс используется для продления SSL-подписки. Продление разрешено только тогда, когда статус SSL-подписки — «Выпущено» и срок действия истекает в течение 30 дней.

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

Название параметра	Тип параметра	Обязательный	Описание
api_token	String	Y	Учётные данные, для генерации токена обратитесь в техническую поддержку Racent.
renewId	String	Y	Идентификатор сертификата racent
years	Int	Y	Срок продления в годах (в настоящее время поддерживаются только 1, 2, 3, 4, 5), зависит от конкретного продукта.
refId	String	N	Уникальный номер заказа клиента, предоставленный клиентом
verificationPic	File	N	Резервные материалы для проверки. Используются для проверки организации, поддерживаются форматы .jpg/.jpeg/.png/.gif/.bmp/.rar/.zip/.pdf, размер не более 2M.
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.
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. Для CFCA — 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(проверка по email) HTTP_CSR_HASH(проверка по файлу) CNAME_CSR_HASH(проверка по DNS) HTTPS_CSR_HASH(проверка по https-файлу)
dcvEmail	String	N	Email для проверки домена. Если способ проверки — EMAIL, это поле обязательно (Y).
domainName	String	N	Доменное имя
organizationInfo	String	N	Информация о компании. При заказе продуктов, требующих корпоративной верификации, этот параметр имеет значение Y. Для CFCA этот параметр имеет значение N. Пример: { "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	Почтовый индекс компании.
Administrator	String	Y	Информация об администраторе, контактное лицо. При подаче заявки на подпись кода, подпись электронной почты или подпись документа этот параметр используется как информация заявки. Кроме того, если параметр csr имеет значение N, эта информация используется для генерации csr. Для CFCA этот параметр имеет значение N. { "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	Название компании администратора.
finance	String		Только для SSL-сертификатов. Информация о финансовом сотруднике. Может совпадать с информацией администратора. Если заказываемый продукт не типа DV, этот параметр обязателен (Y). Для CFCA этот параметр — N. { "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	Компания финансового сотрудника.
tech	String	N	Только для SSL-сертификатов. Информация о техническом сотруднике. Если заказываемый продукт не относится к типу DV, этот параметр является Y. Для CFCA этот параметр — N. { "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	Компания технического специалиста.

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

Название параметра	Тип параметра	Обязательный	Описание
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	Путь к файлу проверки файла