API StopList (ФинЦЕРТ)

Сервис предоставляет методы для получения истории импортов фидов ФинЦЕРТ с возможностью фильтрации по дате и типу фида, мониторинга статуса импортов и анализа данных.

Основные возможности:

• Получение истории импортов фидов.
• Фильтрация данных по дате и типу фида.
• Мониторинг количества записей в файле импорта.
• Анализ частоты обновлений и последовательности импортов.

Получить историю импортов фидов

POST /admin-apps/reports/import-history

Описание

Метод предназначен для получения истории импортов фидов ФинЦЕРТ с возможностью фильтрации по дате и типу фида. Возвращает информацию о каждом импорте, включая количество записей и время импорта.

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

{
  "searchFields": [
    {
      "field": "string", // Имя поля для фильтрации (например, "feed_type", "imported_at")
      "value": "string"  // Значение для фильтрации (например, "phone_number", ">=YYYY-MM-DD HH:MM:SS", "<=YYYY-MM-DD HH:MM:SS")
    }
    // Можно добавить несколько объектов для комбинированных фильтров
  ]
}

Параметры фильтрации:

• "field" (string, обязательный) — имя поля, по которому производится фильтрация. Допустимые значения: "feed_type", "imported_at".
• "value" (string, обязательный) — значение для фильтрации.
  • Для field: "feed_type": строка, соответствующая типу фида (например, "phone_number"). Пустая строка "" означает отсутствие фильтра по типу фида.
  • Для field: "imported_at": строка с оператором сравнения и датой/временем в формате ">=YYYY-MM-DD HH:MM:SS" или "<=YYYY-MM-DD HH:MM:SS".

Возможные value для field: "feed_type":

• "" (пустая строка) — без фильтра по типу.
• passport_hash — хеши паспортов получателей.
• snils_hash — хеши СНИЛС получателей.
• inn — ИНН получателей.
• card_number — номера карт получателей.
• phone_number — номера телефонов получателей.
• account_number — лицевые счета + БИК банка.
• fastpay_number — СБП идентификаторы.
• ewallet_number — электронные кошельки.
• swift — счета + SWIFT БИК банка.

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

[
    {
        "id": 46858,                                    // Уникальный идентификатор импорта
        "feed_type": "phone_number",                    // Тип фида
        "records_count": 1250,                          // Количество записей в импорте
        "imported_at": "2025-10-07T17:11:58.384557+03:00"  // Время импорта
    },
    {
        "id": 45371,
        "feed_type": "card_number",
        "records_count": 186,
        "imported_at": "2025-10-03T17:08:00.234717+03:00"
    },
    {
        "id": 45366,
        "feed_type": "account_number",
        "records_count": 184,
        "imported_at": "2025-10-03T17:07:59.879446+03:00"
    }
]

По умолчанию "searchFields": []

Если отправить запрос с пустым массивом "searchFields": [] без указания конкретных фильтров, то API автоматически применит фильтры по дате за последние 30 дней и все типы фидов:

• Возвращаются все типы фидов: ewallet_number, phone_number, passport_hash, account_number, card_number, inn, snils_hash, fast_pay_number.
• Данные отсортированы по imported_at в убывающем порядке (самые свежие сверху).

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

POST /admin-apps/reports/import-history
Content-Type: application/json

{
  "searchFields": []
}

Фильтр по дате

Выводит все типы фидов в указанном диапазоне дат (например с 1 января по 31 декабря 2025 года).

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

POST /admin-apps/reports/import-history
Content-Type: application/json

{
  "searchFields": [
    {"field": "imported_at", "value": ">=2025-01-01 00:00:00"},
    {"field": "imported_at", "value": "<=2025-12-31 23:59:59"}
  ]
}

Фильтр по типу фида

Так как не задан фильтр по дате и времени, выводит данные по определенному типу фида за последние 30 дней (значение по умолчанию).

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

POST /admin-apps/reports/import-history
Content-Type: application/json

{
  "searchFields": [
    {"field": "feed_type", "value": "card_number"}
  ]
}

Фильтр дата + фид

Например выводит только импорты типа "phone_number" с 1 октября 2025 года по настоящее время.

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

POST /admin-apps/reports/import-history
Content-Type: application/json

{
  "searchFields": [
    {"field": "imported_at","value": ">=2025-10-01 00:00:00"},
    {"field": "feed_type", "value": "phone_number"}
  ]
}