Compliance API

Compliance API предоставляет клиентам Claude Enterprise и Claude Console программный доступ к Activity Feed (ленте активности) их организации. Для организаций Claude Enterprise он также охватывает каталог пользователей, ролей и групп во всех связанных организациях и действующие настройки каждой организации. Кроме того, он даёт доступ к исходным чатам, файлам и проектам в организациях claude.ai, а также к сеансам Cowork, Claude Code, Claude Science, Claude for Microsoft 365 и Claude in Chrome. Команды безопасности, юридические команды и команды по соответствию требованиям используют его для аудита активности, получения или удаления контента и передачи событий в последующие инструменты.

Следующий вызов возвращает самое последнее событие активности в вашей организации. Его может выполнить любой ключ со «scope» (областью действия) read:compliance_activities. Чтобы создать ключ и предоставить ему эту область действия, см. раздел Настройка Compliance API.

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, содержащий data (массив записей Activity), has_more, first_id и last_id:

{
  "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"
}

Как работает Compliance API

Каждая «endpoint» (конечная точка) находится по пути /v1/compliance/* на https://api.anthropic.com, выполняет аутентификацию через заголовок x-api-key и принимает заголовок anthropic-version в каждом запросе. Чтобы получить ключ, см. Настройка Compliance API.

Activity Feed (GET /v1/compliance/activities) доступна любому ключу, имеющему область действия read:compliance_activities; фильтры, пагинацию и полный объект Activity см. в разделе Запрос Activity Feed. Остальные конечные точки требуют Compliance Access Key с соответствующей областью действия.

Тенант Claude Enterprise имеет одну родительскую организацию (контейнер верхнего уровня, централизующий управление идентификацией) со связанными организациями двух видов: организациями claude.ai, где пользователи общаются в чатах и хранят контент, и организациями Claude Console, где пользователи управляют рабочими нагрузками Claude API. Для ключа, охватывающего родительскую организацию, конечные точки каталога (организации, пользователи, роли и группы) возвращают данные из всех связанных организаций обоих видов. Конечные точки контента (чаты, файлы, проекты, вложения проектов и сеансы) обслуживают только данные Claude Enterprise. Конечные точки чатов, файлов и проектов возвращают чаты, файлы и проекты claude.ai. Конечные точки сеансов возвращают транскрипты сеансов Cowork, Claude Code, Claude Science, Claude for Microsoft 365 и Claude in Chrome на компьютерах пользователей (локальные сеансы), записанные, пока пользователи вошли в систему со своей учетной записью Claude Enterprise. Они также возвращают транскрипты сеансов Cowork, запущенных в веб-версии или мобильном приложении claude.ai, которые выполняются в облаке в средах, управляемых Anthropic (удаленные сеансы). Отдельная организация Claude Console (без родительской организации) не входит в тенант Claude Enterprise; она использует ключи Admin API и может выполнять запросы только к Activity Feed.

Все конечные точки /v1/compliance/* используют общее «rate limit» (ограничение скорости) в 600 запросов в минуту на родительскую организацию (для автономной организации Claude Console — на организацию). Конечные точки локальных сеансов учитываются только в рамках этого общего ограничения, а конечные точки удалённых сеансов имеют дополнительный второй бюджет запросов. Заголовки ответа и правила повторных попыток см. в разделе 429 Too Many Requests.

Версионирование

Отправляйте заголовок anthropic-version в каждом запросе; доступные версии см. в разделе Версии API.

Compliance API в сравнении со смежными функциями

Несколько смежных функций пересекаются с Compliance API; вот как сделать выбор.

Экспорт журналов аудита

Экспорт журналов аудита — это отдельная функция в разделе claude.ai > Organization settings > Data and privacy, которая позволяет владельцам и основным владельцам скачивать CSV-файл с событиями организации. Она значительно уже, чем Compliance API: ограниченное окно ретроспективы, только скачивание CSV и отсутствие доступа к содержимому чатов, файлов или проектов. Для постоянного программного использования стандартизируйтесь на Compliance API.

Analytics API

Anthropic предоставляет два аналитических API: Claude Enterprise Analytics API и Claude Code Analytics API. Оба возвращают агрегированные показатели использования и затрат для команд ИТ, FinOps и платформенных команд, тогда как Compliance API возвращает записи по отдельным событиям для команд по безопасности, юридическим вопросам и соответствию требованиям. Эти два семейства API отвечают на разные вопросы, используют разные ключи и подключаются отдельно.

Логирование OpenTelemetry

Логирование OpenTelemetry в Cowork и мониторинг Claude Code передают телеметрию по отдельным событиям, включая метаданные о токенах, затратах и хостах, в коллектор, который вы запускаете, по мере возникновения активности, тогда как Compliance API возвращает сохранённые транскрипты по сеансам от Anthropic по запросу и работает с вашим существующим Compliance Access Key. Логирование OpenTelemetry также может фиксировать подсказки и ответы, но Anthropic рекомендует Compliance API для получения содержимого сеансов Cowork и Claude Code. Таблицу сравнения локальных сеансов, удалённых сеансов и логирования OpenTelemetry см. во введении к разделу Получение транскриптов сеансов.

Хуки инференса

Хуки инференса (бета) действуют в режиме реального времени: сервер ИИ-безопасности вашей организации получает каждую контролируемую подсказку до инференса и может отклонить её в реальном времени, тогда как Compliance API извлекает записи постфактум и возвращает более богатые данные, такие как настройки организации и полные нетекстовые файлы.

В этом разделе