Метод: certificate

Метод используется для получения данных о выпущенном сертификате OZON.

---

URL

POST https://api-pvk.prostodar.ru/partner/ozon/certificate/

---

Описание

Метод позволяет получить информацию о выпущенном сертификате, включая его идентификатор, номинал, кодовое слово и срок действия.

---

Структура запроса

Пример запроса

Формат запроса:

POST https://api-pvk.prostodar.ru/partner/ozon/certificate/ ?partnerName=name &partnerPassword=password &requestId=some_request_id &useAuthByCert=Y

---

Параметры запроса

Параметр	Тип	Описание	Обязательный	Шифрование	Цвет
partnerName	string	Уникальное имя партнера	Да	Нет
partnerPassword	string	Уникальный API пароль партнера	Да	Да
requestId	string	Уникальный идентификатор запроса	Да	Да
useAuthByCert	string	Указывает на использование шифрования данных	Да	Нет

---

Структура ответа

Пример успешного ответа

{
  "id": "0002223334448",
  "codeWord": "some_code_word",
  "nominalValue": 1000,
  "activationDateUntil": "2024-12-31T23:59:59Z",
  "status": "1"
}

Параметры успешного ответа

Параметр	Тип	Описание
id	string	Уникальный идентификатор (серийный номер) сертификата
codeWord	string	Кодовое слово, связанное с сертификатом
nominalValue	float	Номинал сертификата
activationDateUntil	string	Дата, до которой действует сертификат (ISO формат)
status	int	Статус сертификата

Пример ответа с ошибкой

{
  "status": "PARTNER_LOGIN_IS_NOT_CORRECT",
  "message": "Partner name or password is not correct"
}

---

Параметры ответа с ошибкой

Параметр	Тип	Описание
status	string	Статус ошибки
message	string	Текстовое описание ошибки

Возможные ошибки

Статус	Текстовое описание ошибки	Описание
PARTNER_LOGIN_IS_NOT_CORRECT	Partner name or password is not correct	Партнер с таким логином и паролем не найден
NOT_VALID_IP_PARTNER	Partner IP is not correct	IP партнера некорректен
ACCOUNT_IS_BLOCKED	Account is blocked	Аккаунт заблокирован
REQUEST_INCORRECTLY	Invalid authorization is used	Ошибка в шифровании сертификатом
SERVICE_UNAVAILABLE	Service is temporarily unavailable.	Сервис временно недоступен
OZON_ERROR	Значения аргументов.	Ошибка на стороне Озон. В сообщении указаны аргументы, в которых произошла ошибка.
INAPPROPRIATE_STATUS	Значения аргументов.	Заказ находится в неподходящем статусе. Возможно уточнить статус через некоторое время (5-10 минут) или отменить заказ.