Оформление

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

Антибот помогает отличать нежелательные посещения от полезного трафика. API позволяет программно создавать и обновлять антиботы.

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

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

Тело ​

json
{
  "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Название.
stateWorking / Active / Stopped / Paused / Archived.
predictionCountStrategyУстарело. Поле принимается ради совместимости и игнорируется: строгость антибота больше не настраивается.
antiBotSmartInitialReferrerSupressionДополнительно учитывает подозрительный источник первого перехода.
goals[]Цели проекта. Для антибота Optimization — ботоподобное/нежелательное поведение, Minus — полезное поведение, которое нельзя отсекать.
integrationsМассив настроек интеграций, если результат нужно доставлять наружу. Без настройки внешняя отправка не создаётся автоматически.

Работой антибота управляйте через state. Отдельного запроса на принудительный пересчёт нет. Перед PUT получите сущность через GET и сохраните остальные поля: PUT заменяет её полностью. Для изменения отдельных полей используйте PATCH — см. общие правила.

Ответ ​

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

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

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

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