2.3 Получение статуса заявки на сертификат
2.3.1 Информация об API
| Тестовая среда | |
|---|---|
| Рабочая среда | https://portal.racent.com/ssl/collect |
| Метод запроса | POST |
| content-type | multipart/form-data |
| Описание | Этот интерфейс используется для получения статуса заказа сертификата, получения сертификата и получения информации для проверки. |
2.3.2 Определение параметров
| Название параметра | Тип параметра | Обязательный | Описание |
|---|---|---|---|
| certId | String | Y | Идентификатор сертификата racent |
| api_token | String | Y | Учётные данные; для генерации токена обратитесь в техническую поддержку Racent. |
Возврат функции
| Название параметра | Тип параметра | Обязательный | Описание |
|---|---|---|---|
| code | int | Y | Статус возврата; подробное описание см. в Приложении 3.1 |
| status | String | Y | Статус заказа: PENDING: в обработке COMPLETE: оформлен успешно CANCELLED: отменён REISSUED: перевыпущен FAILED: оформление не удалось RENEWED: продлён REVOKED: отозван |
| certStatus | String | Y | Статус сертификата: PENDING: в обработке COMPLETE: оформлен успешно CANCELLED: отменён REISSUED: перевыпущен FAILED: оформление не удалось RENEWED: продлён REVOKED: отозван |
| data | Object | N | Возвращаемые данные, подробности ниже |
| failReason | Object | N | Когда статус FAILED, параметр — Y, причина неудачи |
| dataReasons | Array | N | Причины данных |
| key | String | N | Пункт |
| reason | String | N | Причина |
| sysReason | String | N | Системная причина |
| beginDate | String | N | Когда статус COMPLETE, параметр — Y, время начала действия сертификата |
| endDate | String | N | Когда статус COMPLETE, параметр — Y, время окончания действия сертификата |
| certificate | String | N | Когда статус COMPLETE, параметр — Y, pem-сертификат |
| caCertificate | String | N | Если статус COMPLETE, параметр имеет значение Y, pem-промежуточный сертификат |
| jks | String | N | Если статус COMPLETE и у racent есть корректная информация о закрытом ключе, параметр имеет значение Y, содержимое jks-сертификата в кодировке base64. |
| jksPass | String | N | Если статус COMPLETE и у racent есть корректная информация о закрытом ключе, параметр имеет значение Y, пароль jks-сертификата. |
| pkcs12 | String | N | Если статус COMPLETE и у racent есть корректная информация о закрытом ключе, параметр имеет значение Y, содержимое PKCS12-сертификата в кодировке base64. |
| pkcsPass | String | N | Если статус COMPLETE и у racent есть корректная информация о закрытом ключе, параметр имеет значение Y, пароль PKCS12-сертификата. |
| privateKey | String | N | Если статус COMPLETE и у racent есть корректная информация о закрытом ключе, параметр имеет значение Y, информация о закрытом ключе |
| rsaPrivateKey | String | N | Закрытый ключ в формате rsa, если статус COMPLETE и у racent есть корректная информация о закрытом ключе, параметр имеет значение Y, информация о закрытом ключе |
| replaceCertId | String | N | Если статус REISSUED, параметр имеет значение Y, идентификатор перевыпущенного сертификата racent |
| oldCertId | String | N | Если заявка на сертификат является перевыпуском, параметр имеет значение Y, идентификатор старого сертификата racent |
| vendorId | String | N | Номер заказа CA |
| vendorCertId | String | N | Номер сертификата CA (номер заказа Sectigo) |
| DCVfileName | String | N | Проверка домена через файл, имя файла |
| DCVfileContent | String | N | Проверка через файл, содержимое файла |
| DCVdnsHost | String | N | DNS-проверка, host |
| DCVdnsValue | String | N | DNS-проверка, value |
| DCVdnsType | String | N | DNS-проверка, type |
| dcvInfo | Object | N | Если значения проверки для каждого домена в заявке на сертификат различаются, этот параметр — Y Каждый элемент имеет тип Object, имя объекта — запрашиваемый домен, например: racent.com. Подробности по каждому элементу: |
| DCVfileName | String | N | Проверка домена через файл, имя файла |
| DCVfileContent | String | N | Проверка файла, содержимое файла |
| DCVdnsHost | String | N | Проверка DNS, host |
| DCVdnsValue | String | N | Проверка DNS, value |
| DCVdnsType | String | N | Проверка DNS, type |
| DCVfilePath | String | N | Путь к файлу для проверки файла |
| dcvList | Array | N | Список проверки домена, каждый элемент имеет тип Object, подробности по каждому элементу ниже: |
| domainName | String | N | Доменное имя |
| dcvMethod | String | N | Метод проверки домена |
| dcvEmail | String | N | Электронная почта для проверки домена |
| is_verify | String | N | Проверенное значение параметра — «verified», при отсутствии проверки параметра нет |
| application | Object | N | Статус отправки заказа |
| status | String | N | Параметр принимает одно из следующих значений: notdone: не завершено done: завершено ongoing: выполняется |
| dcv | Object | N | Статус проверки домена |
| status | String | N | Параметр принимает одно из следующих значений: notdone: не завершено done: завершено ongoing: выполняется |
| ov | Object | N | Статус проверки организации |
| status | String | N | Параметр принимает одно из следующих значений: notdone: не завершено done: завершено ongoing: выполняется |
| issued | Object | N | Статус выпуска |
| status | String | N | Параметр принимает одно из следующих значений: notdone: не завершено done: завершено ongoing: выполняется |
| applyParams | Object | N | Параметры заявки. Подробнее см. параметры запроса интерфейса заявки (place) |
| csr | String | N | csr |
| Administrator | Object | N | Информация об администраторе |
| job | String | N | Должность |
| city | String | N | Город |
| 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 | Object | N | Информация о техническом специалисте; конкретные поля совпадают с информацией об администраторе |
| finance | Object | N | Информация о финансовом специалисте; конкретные поля совпадают с информацией об администраторе |
| organizationInfo | Object | N | Информация о компании |
| organizationCity | String | N | Город |
| organizationName | String | N | Название |
| organizationMobile | String | N | Телефон |
| organizationAddress | String | N | Адрес |
| organizationCountry | String | N | Страна |
| organizationPostCode | String | N | Почтовый индекс |
| organizationRegNumbe | String | N | Номер регистрационного документа компании. Для CFCA это поле — Y. |
| idType | String | N | Тип регистрационного документа компании. Для CFCA это поле — Y. Возможные значения: TYDMZ: Единый код социального кредита OTHERS: Другое |
| errors | Object или String | N | Когда возвращается статус ошибки — конкретное сообщение об ошибке. |