Web Check · возможность

API аудита сайта (53 проверки одним JSON-вызовом или по одной)

API аудита сайта в Web Check отдаёт скрипту или сервису тот же движок, который рисует страницы-отчёты. Вы отправляете GET-запрос с адресом страницы и получаете JSON. У каждой проверки своя ручка, а ещё один вызов запускает полный аудит. Он рассчитан на разработчиков, которым данные аудита требуются в конвейере, на панели мониторинга или во внутреннем инструменте.

API аудита сайта: GET-запрос к audit-full и ответ JSON с оценкой и замечаниями

Что даёт API аудита сайта

Один движок выдаёт два вида результата: страницы-отчёты в браузере и HTTP API. Всё, что вы видите на странице отчёта, можно прочитать как JSON.

Вот эти 53 секции: ai-lite, engagement, ai-access, archives, block-lists, canonical, carbon, cookies, crux, delivery, dns, dns-server, dnssec, firewall, geo-readiness, headers, hreflang, hsts, http-security, image-seo, js-render, link-health, linked-pages, llms-txt, llms-validate, location, mail-config, mixed-content, onpage-seo, ports, privacy, pwa, quality, rank, readability, redirects, robots-txt, schema-org, security-txt, shodan, sitemap, sitemap-deep, social-tags, ssl, status, subdomains, tech-stack, threats, tls-connection, tls-labs, trace-route, txt-records, whois.

Вызовы и устройство ответа

Четыре вызова закрывают большинство задач с API аудита сайта.

GET https://webcheck.asibots.pro/api/audit-full?url=PAGE_URL
GET https://webcheck.asibots.pro/api/ai-lite?url=PAGE_URL
GET https://webcheck.asibots.pro/api/engagement?url=PAGE_URL&llm=1
GET https://webcheck.asibots.pro/api/page-audit?url=PAGE_URL

Как проходит вызов по шагам

Запрос к API аудита сайта проходит пять шагов.

  1. Вы выбираете проверку или audit-full для всего сразу.
  2. Вы отправляете GET с адресом страницы в параметре url.
  3. Сервис отказывает ответом 400, если адрес лежит во внутренней сети, а в остальных случаях запускает проверку.
  4. В полном аудите медленные секции отваливаются по таймауту и не задерживают остальные. Весь прогон занимает около 40 секунд.
  5. Вы получаете JSON, где ключи секций совпадают с названиями проверок. CORS открыт, поэтому скрипт на веб-странице может прочитать ответ напрямую.

История и бейдж с оценкой

Ночной автоаудит собственных сайтов ASI Bots идёт по понедельникам, средам и пятницам и пишет результаты в базу с историей. История публичная: читать её можно через функции site_audits_latest и site_audits_history (Supabase RPC).

Из той же истории питается бейдж. Скрипт score-badge.js, который раздаётся с bugfix.asibots.pro, показывает на любом сайте живой кружок с оценкой и подключается одним тегом.

Где это пригождается на практике

Страницы-отчёты и API работают на одном движке, поэтому цифры в вашем инструменте и на странице приходят из одних и тех же проверок.

Ошибки, лимиты и честные гейты

Частые вопросы

Есть ли один вызов, который возвращает всё сразу?

Да: GET /api/audit-full?url=… возвращает общую оценку, группу, счётчики, замечания по важности и данные всех секций в checks . Он занимает около 40 секунд.

Можно ли вызывать API аудита сайта из браузерного скрипта?

Да. Ответ — JSON, а CORS открыт, так что скрипт на веб-странице может его прочитать. Помните о лимитах: 2 запроса в секунду, а при превышении приходит 429 с текстом.

Где найти список ручек и схему ответа?

На /web-check-api и /web-check-api/spec . Там есть ручки, примеры вызовов и схема ответа.

Открыть документацию API

Читайте также