GET /events

Метод позволяет получить список событий, произошедших с сертификатами. Событие для сертификата возникает, когда:

  • при выпуске данные в форме на выпуск сертификата не прошли проверку;
  • когда завершился выпуск сертификата;
  • когда завершился процесс подписания документов сертификатом;

Событие в новостной ленте можно увидеть в течении 3-х месяцев с момента его возникновения

Параметры

Название Тип Формат Обязательность Описание
afterEventId string Guid false Временная метка, после которой необхоимо получить события. Если параметр указан, то в ответе будут располагаться события, которы были созданы позднее указанной метки.
count string false Количество событий в ответе. Максимальное количество событий 100. По умолчанию - 30

Заголовки

Название Описание
Authorization Заголовок авторизации

Пример

  GET /realty/crypto/v2/events?afterEventId=f7a0fcd6-60ed-4e02-b6a6-d6de8a2458c6
  Authorization: ReestroAuth apiKey=235dc85c-f7f9-4dc0-8bbf-dad9e0185afd&portal.orgid=1748b89b-7d34-4d47-b479-b06b40ab1a30

Ответы

200

События получены. В теле ответа содержится список событий

Тело ответа

Название Тип Формат Обязательность Описание
lastEventId string guid true Метка после которой можно продолжать вычитывание
events array CryptoEvent true Список событий, которые произошли с сертификатами

Заголовки ответа

Название Описание
Content-Type Тип содержимого

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

  1. Сертификат выпущен
  HTTP 200
  Content-Type: Application/json
  {
  "lastEventId": "5a8c791a-6404-4cda-b3f8-f5ec45cd685b",
  "events": [
    {
      "eventId": "5a8c791a-6404-4cda-b3f8-f5ec45cd685b",
      "eventDate": "2011-01-01T15:03:01.012345Z",
      "certificateId": "1f3ba8ad-b868-46f2-9088-56aa2753bc88",
      "certificateFormEvent": {
        "formState": "Released",
        "certificate": {
          "contentId": "cb351abb-36fb-43be-9194-639be38b5617",
          "contentType": "cer",
          "md5": "F7415E33F972C03ABD4F3FED36748F7A"
        },
        "receipt": {
          "contentId": "3a8cf2b8-ee9e-47ca-9ff9-75efced2d52e",
          "contentType": "pdf",
          "md5": "7E0D44C48AF788657EA6F5C4C87589E8"
        }
      }
    }
  ]
}
  1. Данные в форме на выпуск сертификата не прошли проверку
HTTP 200
Content-Type: Application/json
{
  "lastEventId": "5a8c791a-6404-4cda-b3f8-f5ec45cd685b",
  "events": [
    {
      "eventId": "5a8c791a-6404-4cda-b3f8-f5ec45cd685b",
      "eventDate": "2011-01-01T15:03:01.012345Z",
      "certificateId": "1f3ba8ad-b868-46f2-9088-56aa2753bc88",
      "certificateFormEvent": {
        "formState": "ValidationError",
        "error": [
          {
            "code": "Validation",
            "message": "can't validate form data",
            "target": "cryptoAPI",
            "errors": {
              "code": "SmevValidationError",
              "message": "СНИЛС не соответствует данным",
              "target": "cryptoAPI"
            }
          }
        ]
      }
    }
  ]
}
  1. Подписание документов сертификатом завершилось успешно
HTTP 200
Content-Type: Application/json
{
  "lastEventId": "5a8c791a-6404-4cda-b3f8-f5ec45cd685b",
  "events": [
    {
      "eventId": "5a8c791a-6404-4cda-b3f8-f5ec45cd685b",
      "eventDate": "2011-01-01T15:03:01.012345Z",
      "certificateId": "1f3ba8ad-b868-46f2-9088-56aa2753bc88",
      "signEvent": {
        "signatureId": "3aad391b-6995-4074-a2ff-46c7a1dd234e",
        "signState": "Processed",
        "signedFiles": {
          "contentInfo": {
            "contentId": "3a8cf2b8-ee9e-47ca-9ff9-75efced2d52e",
            "contentType": "pdf",
            "contentName": "Договор купли-продажи",
            "md5": "7E0D44C48AF788657EA6F5C4C87589E8"
          },
          "signatures": [
            {
              "contentId": "c6780dbc-126b-44f6-9f7b-7422609d8ebb",
              "contentType": "sig",
              "md5": "F7415E33F972C03ABD4F3FED36748F7A"
            }
          ]
        }
      }
    }
  ]
}

400

Ошибки валидации запроса. В теле ответа содержится описание ошибки Error. Для данного метода возможны следующие ошибки:

Код ошибки Описание
WrongFieldValue Значение поля не соответствует требуемому формату. Поле, формат которого не соответствует, указано в описании ошибки в message

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

  HTTP 400
  Content-Type Application/json
  {
  "code": "validation",
  "message": "Failed to validate input request",
  "target": "api",
  "errors": [
    {
      "code": "WrongFieldValue",
      "message": "afterEventId should be guid",
      "target": "EntityApi"
    }
  ]
}

401

Ошибка авторизации: пользователь не авторизован

403

Ошибка аутентификации: пользователь не имеет доступа к ресурсам организации, которая указана в заголовке авторизации