Запрос ленты активности

Лента активности записывает каждое действие аутентификации, чата, файла, проекта, администрирования и платформы, которое происходит в вашей организации, в обратном хронологическом порядке. Активности доступны для запроса в течение 1 минуты после возникновения и хранятся в течение 6 лет.

curl --fail-with-body -sS \
  "https://api.anthropic.com/v1/compliance/activities?limit=1" \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY"

{
  "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": "[email protected]",
        "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"
}



Фильтрация активностей

Фильтруйте по организации, актору, типу активности или временному окну created_at, используя подпараметры с точкой created_at.gte, .gt, .lte и .lt. См. справочник API для типа и допустимых значений каждого параметра.

Повторяемые параметры используют синтаксис запроса с квадратными скобками массива: передавайте activity_types[]=..., actor_ids[]=... или organization_ids[]=... по одному разу для каждого значения.

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"

Лента активности производит сотни различных типов активности. См. Запрос активностей соответствия в справочнике API для полного списка значений, которые принимает activity_types[].



Разбиение результатов на страницы

Активности возвращаются начиная с самых новых, при совпадении created_at порядок определяется по идентификатору активности, и ограничиваются limit результатами в каждом ответе (по умолчанию 100, максимум 5 000). См. справочник API для полной схемы ответа.

Compliance API использует две схемы разбиения на страницы в зависимости от семейства конечных точек:

Файлы не разбиваются на страницы: они извлекаются по отдельности по идентификатору.

Курсоры разбиения на страницы и токены страниц — это непрозрачные строки: передавайте их обратно без изменений. Их внутренний формат нестабилен, и их разбор перестанет работать без предупреждения. В каждом запросе может быть установлен только один из параметров after_id или before_id, и обе схемы возвращают has_more, чтобы вы знали, когда остановиться.

Чтобы пролистывать страницы активностей:

• Передайте last_id из ответа как after_id, чтобы перейти к следующей странице в порядке результатов. Поскольку активности отсортированы начиная с самых новых, следующая страница содержит более старые записи.
• Передайте first_id как before_id, чтобы вернуться к предыдущей странице.
• Остановитесь, когда has_more равен false.

Параметр курсора задаёт направление страниц; порядок сортировки конечной точки задаёт направление по времени. Тот же параметр after_id здесь ведёт к более старым активностям. Чаты сортируются начиная с самых старых; см. Получение и удаление чатов, файлов и проектов для семантики курсоров там.

# Получаем первую страницу (сначала самые новые действия) и сохраняем её завершающий курсор.
last_id=$(curl --fail-with-body -sS \
  "https://api.anthropic.com/v1/compliance/activities?limit=2" \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" | 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" \
  --data-urlencode "limit=2" \
  --data-urlencode "after_id=${last_id}"

Производственный цикл обратного заполнения (backfill) пролистывает более старые активности, управляя итерацией на основе has_more и last_id:

1. Начните с вашего сохранённого курсора (или опустите after_id, чтобы начать с начала).
2. Пролистывайте страницы с after_id=<last_id>, пока has_more не станет false.
3. Сохраняйте финальный last_id только после того, как вы сохранили каждую страницу, которую он охватывает.

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 со следующей структурой верхнего уровня:

Поле actor — это размеченное объединение (discriminated union). Дискриминатор type указывает, какие другие поля присутствуют:



Следующие шаги