Перейти к основному содержимому

GetMyCertificates

Возвращает список сертификатов, привязанных к текущему авторизованному пользователю.

В ответе метода вернутся только активные по сроку сертификаты пользователя.

GET /GetMyCertificates

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

  • boxId — идентификатор ящика сотрудника в формате GUID.
  • includeGoskeyCertificates — признак того, что в ответ нужно включить сертификаты «Госключ». Используется только в случае, если у авторизованного пользователя в указанном ящике установлено право «Использовать УКЭП Госключ». Необязательный параметр, по умолчанию равен false.

Заголовки запроса

Коды ответа

  • 200 — операция успешно завершена.
  • 400 — данные в запросе имеют неверный формат или отсутствуют обязательные параметры.
  • 401 — в запросе отсутствует HTTP-заголовок Authorization или в этом заголовке содержатся некорректные авторизационные данные.
  • 402 — у указанного ящика закончилась подписка на API.
  • 403 — доступ к ящику с предоставленным авторизационным токеном запрещен.
  • 405 — используется неподходящий HTTP-метод.
  • 429 — превышено ограничение на количество запросов в единицу времени.
  • 500 — при обработке запроса возникла непредвиденная ошибка.

Тело ответа

Тело ответа содержит список сертификатов, представленный структурой CertificateList.

Примеры использования

Пример HTTP-запроса:

GET /GetMyCertificates?boxId={{boxId}} HTTP/1.1
Host: diadoc-api.kontur.ru
Authorization: Bearer {{access_token}}
Accept: application/json

Пример тела ответа:

{
"Certificates": [
{
"Thumbprint": "405D5FBEDE811C1F4DCE49270F0A39789A86E000",
"Type": "Token",
"ValidFrom": 638793650260000000,
"ValidTo": 639187640260000000,
"PrivateKeyValidFrom": 638793650260000000,
"PrivateKeyValidTo": 639187640260000000,
"OrganizationName": "Организация",
"Inn": "2794685000",
"UserFirstName": "Имя",
"UserMiddleName": "Отчество",
"UserLastName": "Фамилия",
"UserShortName": "Фамилия И. О.",
"IsDefault": true,
"SubjectType": "LegalEntity",
"Usages": [],
"DssType": "UnknownDssType"
},
{
"Thumbprint": "DEC5FE8A0DC3E11B04DE55C1EB272BA2F36E6000",
"Type": "Token",
"ValidFrom": 638562072980000000,
"ValidTo": 638956926980000000,
"PrivateKeyValidFrom": 638562072970000000,
"PrivateKeyValidTo": 638956926970000000,
"OrganizationName": "",
"Inn": "332373149000",
"UserFirstName": "Имя",
"UserMiddleName": "Отчество",
"UserLastName": "Фамилия",
"UserShortName": "Фамилия И. О.",
"IsDefault": false,
"SubjectType": "PhysicalPerson",
"Usages": [],
"DssType": "UnknownDssType"
}
]
}

См. также

Методы для работы с сертификатами:

  • CanSendInvoice — позволяет узнать, может ли указанный сертификат использоваться для подписания электронных счетов-фактур
  • GetCounteragentCertificates (V2) — возвращает список сертификатов контрагента
  • GetMyCertificates — возвращает список сертификатов, привязанных к текущему авторизованному пользователю

Оцените материал страницы

Нашли ошибку или столкнулись с проблемой?

СКБ Контурс 1988 года