2.12 Замена информации о SSL-подписке
2.12.1 Информация об API
| Тестовая среда | |
|---|---|
| Рабочая среда | https://portal.racent.com/ssl/replace |
| Метод запроса | POST |
| content-type | multipart/form-data |
| Описание | Этот интерфейс используется для замены информации о подписке SSL. Относится только к SSL-сертификатам. Замена информации о подписке SSL разрешена только тогда, когда статус подписки SSL — «Выдан». |
2.12.2 Определение параметров
| Название параметра | Тип параметра | Обязательный | Описание |
|---|---|---|---|
| api_token | String | Y | Учётные данные, для генерации token обратитесь в техническую поддержку Racent. |
| certId | String | Y | Идентификатор сертификата Racent |
| refId | String | N | Уникальный номер заказа, предоставленный клиентом |
| domainVerificationPic | File | N | Если способ проверки домена — VERIFY_DOCUMENT, этот параметр обязателен (Y). Используется для подтверждения права собственности на домен (в настоящее время поддерживается только CFCA). |
| params | String | Y | Информация для замены, подробное описание ниже |
| csr | String | Y | Примечание: домены в CSR должны совпадать с доменами в CSR исходной SSL-подписки. |
| 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 | Y | Информация о домене. Пример: [ { "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 | Y | Способ проверки домена. Должен быть одним из четырёх способов: EMAIL(проверка по email) HTTP_CSR_HASH(проверка файлом) CNAME_CSR_HASH(проверка DNS) HTTPS_CSR_HASH(проверка https-файлом) Если у верхнего уровня dcvMethod отсутствует, этот параметр обязателен (Y). Если у верхнего уровня dcvMethod существует и этот параметр тоже существует, приоритетно используется dcvMethod верхнего уровня. |
| dcvEmail | String | N | Email для проверки домена. Если этот параметр необязателен (N), значения по умолчанию следующие racent.com : admin@racent.com www.racent.com : admin@racent.com *.racent.com : admin@racent.com |
| domainName | String | Y | Домен |
| organizationInfo | String | N | Когда вам нужно изменить информацию о компании, этот параметр обязателен (Y). |
| organizationCity | String | N | Город, в котором находится компания. |
| organizationName | String | N | Название компании. |
| organizationMobile | String | N | Телефон компании. |
| organizationAddress | String | N | Адрес компании. |
| organizationCountry | String | N | Страна, в которой находится компания (двухбуквенный код по стандарту ISO 3166-1). |
| organizationPostCode | 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 | Путь к файлу для проверки файла |