REST API проверки ссылок
Один запрос — вердикт по адресу и виды найденной угрозы. Пакетный режим принимает до ста ссылок за вызов и возвращает сводку: сколько угроз, сколько адресов проверить не удалось.
Быстрый старт
Подключите проверку ссылок за три шага
Изучите эндпоинты
В Swagger ниже — два метода: одиночная проверка с параметром
url и пакетная batch со списком адресов в теле.
Протестируйте
Выполните GET /api/urlcheck?url=https://example.com —
получите вердикт, виды угрозы и время проверки.
Интегрируйте
Поставьте проверку на публикацию пользовательского контента, а ревизию накопленных ссылок — в ночное расписание пакетом.
Возможности API
Что делает API проверки ссылок удобным для интеграции
REST + JSON
Обычный GET и обычный POST, ответ в JSON без лишних слоёв.
Одиночная проверка
?url= — вердикт по одному адресу за миллисекунды.
Пакет до 100
batch — массив адресов в теле, вердикт по каждому.
Виды угрозы
В ответе не только «плохо», но и что именно найдено.
Отметка времени
Поле с датой и временем проверки — вердикт всегда со сроком.
Сводка по пакету
Сколько всего, сколько угроз, сколько проверить не удалось.
Swagger
Спецификация OpenAPI с параметрами и примерами ответов.
CORS
Удобно для браузерных приложений и dev-инструментов.
Вердикты и виды угрозы
Что каждое значение утверждает — и чего оно не утверждает
| Вердикт | Что утверждает | Чего НЕ утверждает |
|---|---|---|
| clean | На момент проверки записи об угрозе по этому адресу нет | Что сайт безопасен, что ему можно доверять и что он останется чистым завтра |
| threat | Угроза числится; её виды перечислены в поле threatTypes |
Что угроза активна прямо сейчас: владелец мог вычистить сайт после попадания в списки |
| unknown | Проверка не выполнена. Такой адрес не тарифицируется | Ни первого, ни второго. Это отсутствие ответа, а не мягкое разрешение |
malware
Страница доставляет на устройство программу — загрузкой файла или через уязвимость браузера.
social_engineering
Страница выдаёт себя за чужую и собирает введённое: логин, пароль, код подтверждения, данные карты.
unwanted_software
Устанавливается что-то сверх обещанного: подмена стартовой страницы и поиска, навязанная реклама, «оптимизаторы».
unknown как clean велик: так проще писать код и
ничего не ломается в обычный день. Но именно это превращает временную
недоступность проверки в открытую дверь. Правильная обработка — повторить
позже или отправить запись на ручной разбор; такие адреса не тарифицируются,
поэтому повтор ничего не стоит.
Нужна помощь с интеграцией?
Используйте Swagger ниже и примеры параметров. Для теста подойдут Postman, Thunder Client или curl.
Swagger документация API
Откройте спецификацию OpenAPI, чтобы проверить запросы и ответы API проверки ссылок.
Почему выбирают наш API
Преимущества REST API проверки ссылок для интеграции
Простая интеграция
Два понятных эндпоинта без SDK и без состояния. Подключается любым HTTP-клиентом за один вечер.
Подходит для потока
Пакет на сто адресов и повторы, схлопывающиеся до проверки, — ревизия каталога из десятков тысяч ссылок укладывается в минуты.
Платите за проверенное
Единица — один проверенный адрес. Дубликаты в пакете считаются
один раз, адреса с вердиктом unknown из счёта исключаются.
Ничего не открывается
Проверяется адрес: страница не запрашивается, скрипты не выполняются, содержимое не попадает ни к вам, ни к вашим пользователям.
Готовы подключить проверку ссылок?
Встройте API в модерацию и разбор входящей почты или откройте GUI для ручной проверки.