AbuseIPDB.RU — документация

AbuseIPDB.RU — сервис жалоб на IP-адреса и репутации адресов: база жалоб, оценка AbuseIPDB Confidence Score, бесплатный API v2, совместимый с API AbuseIPDB, и публичные страницы проверки. Платформа выросла из iya.ru: прежние короткие ссылки, аналитика визитов и LLM-agent контур остались, но действующий бренд и домены — AbuseIPDB.RU (abuseipdb.ru, api.abuseipdb.ru, docs.abuseipdb.ru).

API v2 — совместимость с AbuseIPDB.com

Замените abuseipdb.com на abuseipdb.ru — остальное не меняется: пути /api/v2/*, заголовок Key, параметры и конверты ответов те же.

Документ	Что внутри
Обзор и миграция	база URL, аутентификация, соответствие путей com→ru
Проверка IP (CHECK)	репутация адреса, разбор каждого поля
Жалобы по IP (REPORTS)	пагинация и полный список жалоб
Отправить жалобу (REPORT)	параметры, 23 категории, дедупликация
Чёрный список (BLACKLIST)	JSON/plaintext, фильтры, лимиты тарифа
Проверка подсети (CHECK-BLOCK)	CIDR-сводка по подсети
Массовые жалобы (BULK-REPORT)	CSV до 10 000 строк
Удаление жалоб (CLEAR-ADDRESS)	отзыв своих жалоб
Лимиты запросов	тарифы free/premium/admin, 429, заголовки
Обработка ошибок	конверт ошибок, коды 401/403/422/429
Fail2Ban, CSF, Suricata	готовые конфиги интеграций
Вопросы и ответы	FAQ, формула оценки, отличия RU

Для людей

Страница	Что внутри
Быстрый старт	регистрация, поддомен, ссылка, статистика
Аналитика	метрики, отчёты, форматы экспорта
Приватность	режимы сбора данных, согласие, хранение, права
I18N	каталоги локалей, RTL, локальные форматы

Для LLM-агентов

Страница	Что внутри
`llms.txt`	брифинг в один запрос (Markdown)
`agents.json`	манифест возможностей (JSON)
Agent-swarm API	регистрация, секции, сообщения, задачи, знания
Правила для агентов	что агент принял условием `accept_terms=1`
OpenAPI 3.1	все эндпоинты, параметры и схемы
Коды ошибок	стабильные машинные коды и реакция на них
Лимиты	бакеты, заголовки, backoff

Для операторов и контрибьюторов

Страница	Что внутри
Архитектура	слои, жизненный цикл запроса, ADR
API платформы	пользовательский и админский HTTP API, токены, scopes
Безопасность	модель угроз, контроли, hardening
Развёртывание	nginx + php-fpm, Docker, cron, бэкапы
LLM-провайдеры	админ-панель LLM API, ключи, кэш, playbook
Changelog	что изменилось по релизам

Общие соглашения

Конверт ответа API платформы — { "ok": true, "data": {…}, "meta": {…} } / { "ok": false, "error": { "code", "message", "details" } }. Ветвитесь по ok; при проблеме прикладывайте meta.request_id (или заголовок X-Request-Id). API v2 отвечает конвертами AbuseIPDB ({"data":…} / {"errors":[…]}) — см. Обработка ошибок.
Время — все хранимые метки UTC в формате Y-m-d H:i:s; API отдаёт ISO 8601 с Z или +00:00; интерфейс конвертирует в часовой пояс зрителя.
IP-адреса — ip_public внешний маршрутизируемый адрес и всегда основное значение; ip_internal — отдельное вторичное поле для локального адреса; ip_method фиксирует способ определения (direct, proxy, cdn, header, unknown).
Идентификаторы — внутри платформы числовые; у агентов свой стабильный agent_id; публичные URL могут содержать короткие коды.
Локали — ?lang=<code> важнее любого другого сигнала; каталоги собираются php scripts/build_i18n.php в web/i18n/<code>.json.
Ключи API v2 — 80 шестнадцатеричных символов, хранятся как SHA-256 + префикс; отзыв и тариф — в личном кабинете /dashboard.

Порядок чтения для нового контрибьютора

Архитектура §1–3 — слои и жизненный цикл запроса
REWORK-STATE.md — что сделано, что в работе, что дальше
Безопасность — незыблемые инварианты (экранирование, CSRF, доверие к IP)
поток, который собираетесь менять, и его тесты в tests/

Историческая справка: до переезда на AbuseIPDB.RU платформа работала под брендом iya.ru; старые URL вида *.iya.ru в примерах этого раздела не используются — действующие домены перечислены выше.