# Управление антиботами

Антибот — это ML-классификатор «сессия бот / человек», тренируемый на трафике вашего проекта. CRUD позволяет программно заводить и редактировать антибот-модели.

База: https://api.sales-ninja.me/public/api/v1/manage/antibots

HTTP Что делает
GET / Список антиботов.
POST /list Список со сложным фильтром.
GET /{id} Полная сущность.
POST / Создать.
PUT /{id} Обновить.
PATCH /{id} Частично обновить root-поля.
DELETE /{id} Удалить.

# Тело

{
  "title": "Антибот: чекаут",
  "state": "Working",
  "predictionCountStrategy": "Balanced",
  "antiBotSmartInitialReferrerSupression": false,
  "goals": [
    {
      "goalId": "aaaa1111-2222-3333-4444-555566667777",
      "isMain": true,
      "relationType": "Optimization",
      "contributionPower": 10.0
    },
    {
      "goalId": "11112222-3333-4444-5555-666677778888",
      "isMain": false,
      "relationType": "Minus",
      "contributionPower": 1.0
    }
  ],
  "integrations": []
}

# Поля

Поле Описание
title Название.
state Working / Active / Stopped / Paused / Archived.
predictionCountStrategy Balanced, MoreAccuracy, MorePredictCount, CustomPredictionRate, MaxAccuracy.
antiBotSmartInitialReferrerSupression Включает дополнительное подавление подозрительных initial referrer-сценариев.
goals[] Цели проекта для обучения антибота. Для антибота Optimization — ботоподобное/нежелательное поведение, Minus — хорошее поведение, которое нельзя отсекать.
integrations Массив настроек интеграций, если результат нужно доставлять наружу. Без настройки внешняя отправка не создаётся автоматически.

Запуск и остановка обучения — через состояние сущности, отдельных программных триггеров нет.

# Ответ

{
  "antiBotId": "8f3a1e4b-…",
  "entity": {
    "id": "8f3a1e4b-…",
    "title": "Антибот: чекаут"
  }
}

# Доступные источники сигналов

goals[].goalId указывает на цели проекта, которые могут опираться на разные платформы. Полный каталог источников и их предусловий — на странице Сигналы для ML.

# Связанные страницы