GetMyCertificates

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

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

GET /GetMyCertificates

Query Parameters:

• boxId – идентификатор ящика сотрудника.

Request Headers:

• Authorization – данные, необходимые для авторизации.

Status Codes:

• 200 OK – операция успешно завершена.

• 401 Unauthorized – в запросе отсутствует HTTP-заголовок Authorization или в этом заголовке содержатся некорректные авторизационные данные.

• 402 Payment Required – у указанного ящика закончилась подписка на API.

• 403 Forbidden – доступ к ящику с предоставленным авторизационным токеном запрещен.

• 405 Method Not Allowed – используется неподходящий HTTP-метод.

• 500 Internal Server Error – при обработке запроса возникла непредвиденная ошибка.

Response Body:

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

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

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

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

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

{
    "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 — возвращает список сертификатов, привязанных к текущему авторизованному пользователю