--- title: Запросы к ленте активности url: https://platform.claude.com/docs/ru/manage-claude/compliance-activity-feed description: Получение, фильтрация и постраничная навигация по ленте активности Compliance API вашей организации. --- Чтобы включить Compliance API (API для соблюдения нормативных требований), см. раздел [Настройка Compliance API](https://platform.claude.com/docs/ru/manage-claude/compliance-api-access). **Требуемая область доступа:** `read:compliance_activities` на ключе Compliance Access Key или ключе Admin API. Вызывать ленту активности (Activity Feed) могут как ключи Compliance Access Key (`sk-ant-api01-...`), имеющие эту область доступа, так и ключи Admin API (`sk-ant-admin01-...`). Условия, при которых каждый тип ключа получает эту область доступа, см. в разделе [Настройка Compliance API](https://platform.claude.com/docs/ru/manage-claude/compliance-api-access). Лента активности фиксирует события аутентификации, чатов, файлов, проектов, административные действия и активность платформы по всей вашей организации и возвращает их в обратном хронологическом порядке. Действия становятся доступны для запросов в течение 1 минуты после их совершения и хранятся 6 лет. Запись не ведётся ретроактивно: она начинается с момента первого включения Compliance API для вашей организации, а активность до включения не восполняется. ```bash cURL curl --fail-with-body -sS \ "https://api.anthropic.com/v1/compliance/activities?limit=1" \ --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \ --header "anthropic-version: 2023-06-01" ``` ```json Response { "data": [ { "id": "activity_01XyDMpzjS89pFZXqSFUBDr6", "created_at": "2026-04-10T08:09:10Z", "organization_id": "org_01Wv6QeBcDfGhJkLmNpQrSt8", "organization_uuid": "abcdef01-2345-6789-abcd-ef0123456789", "actor": { "type": "user_actor", "email_address": "user@example.com", "user_id": "user_01TuVwXyZaBcDeFgH2JkLmN4", "ip_address": "192.0.2.34", "user_agent": "Mozilla/5.0..." }, "type": "claude_chat_created", "claude_chat_id": "claude_chat_01XyDMpzjS89pFZXqSFUBDr6", "claude_project_id": "claude_proj_01KGp4eZNug9ri4kE35RSppq" } ], "has_more": true, "first_id": "activity_01XyDMpzjS89pFZXqSFUBDr6", "last_id": "activity_01XyDMpzjS89pFZXqSFUBDr6" } ``` ## Фильтрация действий Фильтруйте по организации, субъекту (actor), типу действия или временному окну `created_at`, используя точечные подпараметры `created_at.gte`, `.gt`, `.lte` и `.lt`. Тип и допустимые значения каждого параметра см. в [справочнике API](https://platform.claude.com/docs/ru/api/compliance/activities/list). Повторяемые параметры используют синтаксис запроса с квадратными скобками массива: передавайте `activity_types[]=...`, `actor_ids[]=...` или `organization_ids[]=...` по одному разу для каждого значения. ```bash cURL curl --fail-with-body -sS -G \ "https://api.anthropic.com/v1/compliance/activities" \ --data-urlencode "activity_types[]=claude_file_uploaded" \ --data-urlencode "activity_types[]=claude_chat_created" \ --data-urlencode "created_at.gte=2026-04-01T00:00:00Z" \ --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \ --header "anthropic-version: 2023-06-01" ``` Лента активности формирует сотни различных типов действий. Полный список значений, которые принимает `activity_types[]`, см. в разделе [Запрос действий соответствия](https://platform.claude.com/docs/ru/api/compliance/activities/list) справочника API. ## Постраничная навигация по результатам Действия возвращаются начиная с самых новых; при совпадении `created_at` порядок определяется идентификатором действия, а количество результатов в каждом ответе ограничено значением `limit` (по умолчанию 100, максимум 5 000). Полную схему ответа см. в [справочнике API](https://platform.claude.com/docs/ru/api/compliance/activities/list). Compliance API использует две схемы «pagination» (постраничной навигации) в зависимости от семейства конечных точек: | Семейство конечных точек | Порядок сортировки | Схема | Параметры | | ------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------- | -------------- | ---------------------------------------------------------------- | | Действия | Сначала новые | Курсор | `after_id`, `before_id` (возвращаются как `first_id`, `last_id`) | | Чаты и сообщения чатов | Сначала старые | Курсор | `after_id`, `before_id` (возвращаются как `first_id`, `last_id`) | | Организации, проекты, вложения проектов, пользователи, роли, разрешения ролей, группы, участники групп | Зависит от конечной точки | Токен страницы | `page` (возвращается как `next_page`) | | Локальные и удалённые сеансы и сообщения сеансов | Сеансы — сначала новые; сообщения — по умолчанию сначала старые | Токен страницы | `page` (возвращается как `next_page`) | Файлы не разбиваются на страницы: они извлекаются по отдельности по идентификатору. Курсоры постраничной навигации и токены страниц — это непрозрачные строки: передавайте их обратно без изменений. Их внутренний формат нестабилен, и попытка их разбора перестанет работать без предупреждения. В каждом запросе может быть задан только один из параметров `after_id` или `before_id`, и обе схемы возвращают `has_more`, чтобы вы знали, когда остановиться. Исключение составляют конечные точки сеансов (локальных и удалённых): они возвращают `next_page` без `has_more`, поэтому останавливайтесь, когда `next_page` равен `null`. Чтобы пролистать действия по страницам: * Передайте `last_id` из ответа в качестве `after_id`, чтобы перейти к следующей странице в порядке результатов. Поскольку действия отсортированы начиная с новых, следующая страница содержит более старые записи. * Передайте `first_id` в качестве `before_id`, чтобы вернуться к предыдущей странице. * Остановитесь, когда `has_more` равно `false`. Параметр курсора задаёт направление листания страниц; порядок сортировки конечной точки задаёт направление во времени. Здесь тот же параметр `after_id` ведёт к более старым действиям. Чаты сортируются начиная со старых; семантику курсоров для них см. в разделе [Получение и удаление чатов, файлов и проектов](https://platform.claude.com/docs/ru/manage-claude/compliance-content-data). **Курсоры безопасно использовать повторно при повторных попытках.** Курсор или токен страницы из успешно возвращённой страницы остаётся действительным; запрос, завершившийся ошибкой (5xx, тайм-аут, сетевая ошибка), не продвигает вашу позицию. Повторите тот же запрос с тем же курсором. Переходите к следующему курсору только после того, как сохранили страницу, за которую он указывает. Исключение при длительных паузах составляют токены страниц на конечных точках локальных сеансов. На [конечной точке сообщений локального сеанса](https://platform.claude.com/docs/ru/manage-claude/compliance-sessions#retrieve-a-local-session-transcript) токены `page` одного прохода истекают через 24 часа после его первой страницы (проход — это одно прохождение по страницам), поэтому завершите или возобновите его в пределах этого окна либо начните заново без параметра `page`. В [списке локальных сеансов](https://platform.claude.com/docs/ru/manage-claude/compliance-sessions#retrieve-local-sessions) более старый токен `page` по-прежнему принимается, но пересчитывается относительно текущей границы хранения и может пропускать сеансы, поэтому проходы по списку также завершайте в течение 24 часов. ```bash cURL # Получаем первую страницу (сначала новые действия) и сохраняем её завершающий курсор. last_id=$(curl --fail-with-body -sS \ "https://api.anthropic.com/v1/compliance/activities?limit=2" \ --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \ --header "anthropic-version: 2023-06-01" | jq -er '.last_id') # Передаём курсор обратно без изменений, чтобы получить следующую (более старую) страницу. curl --fail-with-body -sS -G \ "https://api.anthropic.com/v1/compliance/activities" \ --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \ --header "anthropic-version: 2023-06-01" \ --data-urlencode "limit=2" \ --data-urlencode "after_id=${last_id}" ``` Производственный цикл **восполнения** (backfill) листает более старые действия, управляя итерацией на основе `has_more` и `last_id`: 1. Начните с сохранённого курсора (или опустите `after_id`, чтобы начать с начала). 2. Листайте страницы с `after_id=`, пока `has_more` не станет `false`. 3. Сохраняйте итоговый `last_id` только после того, как сохранили все страницы, которые он охватывает. ```text cursor = stored_cursor loop: if cursor is not null: page = GET /v1/compliance/activities?after_id={cursor}&limit=100 else: page = GET /v1/compliance/activities?limit=100 store(page.data) if page.last_id is not null: cursor = page.last_id if not page.has_more: break persist(cursor) ``` ## Структура объекта Activity Каждая запись в `data` — это объект Activity со следующей структурой верхнего уровня: | Поле | Тип | Описание | | --------------------- | ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `id` | string | Уникальный идентификатор действия. | | `created_at` | строка RFC 3339 | Когда произошло действие. | | `organization_id` | string или null | Организация, в которой произошло действие, или `null` для событий, не привязанных к организации (вход, выход, вызовы Compliance API). | | `organization_uuid` | string или null | Та же область, что и у `organization_id`, выраженная в виде UUID. | | `actor` | объединение Actor | Кто или что выполнило действие. См. таблицу субъектов ниже. | | `type` | string | Тип действия, например `claude_chat_created`. | | *дополнительные поля* | различается | Поля, зависящие от типа, например `claude_chat_id` в событиях чатов или `claude_file_id` в событиях файлов. Список полей для каждого типа приведён в разделе [Запрос действий соответствия](https://platform.claude.com/docs/ru/api/compliance/activities/list) справочника API. | Поле `actor` — это размеченное объединение (discriminated union). Дискриминатор `type` указывает, какие другие поля присутствуют: | `actor.type` | Когда появляется | Ключевые поля | | ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `user_actor` | Действие выполнил вошедший в систему пользователь claude.ai или Claude Console либо процесс, который Anthropic запускает от имени этого пользователя (см. абзац после этой таблицы). | `email_address`, `user_id`, `ip_address`, `user_agent` | | `api_actor` | Запрос обратился к Claude API или Compliance API с ключом API, выданным клиентом. Вызовы Compliance API формируют этот тип субъекта как для ключей Compliance Access Key, так и для ключей Admin API. | `api_key_id`, `ip_address`, `user_agent` | | `admin_api_key_actor` | Администратор организации использовал ключ Admin API для управления пользователями, приглашениями, рабочими пространствами или ключами API. | `admin_api_key_id`, `ip_address`, `user_agent` | | `unauthenticated_user_actor` | Действие произошло до завершения входа, например `sso_login_initiated`. | `unauthenticated_email_address`, `ip_address`, `user_agent` | | `anthropic_actor` | Anthropic выполнила действие в отношении организации, например с помощью внутренних инструментов. | `email_address` (всегда `null`; присутствует для единообразия структуры с `user_actor`, поскольку операторы Anthropic не представлены индивидуальными адресами электронной почты) | | `system_actor` | Автоматическая фоновая обработка, выполняемая системами Anthropic без учётных данных пользователя или клиента. | `service` (может быть null; имя автоматического процесса, выполнившего действие, если оно известно) | | `scim_directory_sync_actor` | Поставщик удостоверений (например, Okta, Microsoft Entra ID или JumpCloud) передал изменение через синхронизацию каталога SCIM. | `workos_event_id`, `directory_id`, `idp_connection_type` (может быть null; например, `OktaSCIMV2`, `AzureSCIMV2`) | Действие `user_actor` не всегда означает, что его выполнил пользователь. Процессы, которые Anthropic запускает от имени пользователя, в настоящее время могут отображаться как `user_actor` для затронутого пользователя, а не как `system_actor`, и такая атрибуция может измениться. Например, так атрибутируются действия с памятью, возникшие в результате миграции, такие как `platform_memory_store_created`, `platform_memory_created` и `platform_memory_deleted`. Действия с памятью могут показывать `ip_address` со значением `0.0.0.0` независимо от того, кто их выполнил, поэтому само по себе это значение не позволяет определить активность платформенного процесса. Действие `claude_*_viewed` означает, что приложение Claude загрузило содержимое, а не то, что его просмотрел человек. Такие типы, как `claude_chat_viewed`, `claude_file_viewed` и `claude_project_viewed`, записываются каждый раз, когда приложение Claude загружает чат, файл или проект с серверов Anthropic. Повторные загрузки не дедуплицируются. Веб-, настольное и мобильное приложения загружают содержимое в разные моменты, иногда в фоновом режиме, и могут отображать кэшированную копию без её загрузки. В результате количество таких действий различается в зависимости от платформы и не соответствует числу отправленных сообщений или просмотренных экранов. Действия, связанные с файлом, документом проекта или артефактом, не содержат его имени или заголовка. Начиная с 24 сентября 2026 года поля `filename` и `title` в таких действиях всегда равны `null`, пустой строке или отсутствуют, в том числе в действиях, записанных до этой даты. Чтобы узнать имя или заголовок, передайте идентификатор `claude_file_*`, `claude_proj_doc_*` или `claude_artifact_version_*` из действия в соответствующую конечную точку метаданных из раздела [Получение файлов и артефактов](https://platform.claude.com/docs/ru/manage-claude/compliance-content-data#retrieve-files-and-artifacts), используя Compliance Access Key с областью доступа `read:compliance_user_data`. Узнать имя или заголовок невозможно после удаления файла, документа или артефакта, а также если в действии нет такого идентификатора. **Создавайте обработчики с прямой совместимостью.** Пропускайте нераспознанные значения `type` и `actor.type` и игнорируйте поля, которых ваш обработчик не ожидает, чтобы ваша интеграция продолжала работать при появлении новых типов действий. ## Следующие шаги Полная схема запроса и ответа для `GET /v1/compliance/activities`, включая все поддерживаемые значения `activity_types[]`. Запрашивайте и удаляйте исходное содержимое для действий, найденных в ленте (требуется ключ Compliance Access Key). Выберите схему потребления — опрос или пакетную обработку — и спланируйте корреляцию с SIEM. Полный каталог ошибок.