REST API аудита сайта
Один запрос — четыре оценки, лабораторные метрики, данные реальных посетителей и перечень узких мест с экономией в миллисекундах. Профиль устройства выбирается параметром; пакетный режим принимает до двадцати адресов.
Быстрый старт
Подключите аудит сайта за три шага
Изучите эндпоинты
В Swagger ниже — одиночный замер с параметрами url,
strategy, forceRefresh и пакетный batch.
Поставьте таймаут
Ответ занимает 10–30 секунд. Таймаут клиента — не меньше 120 секунд, иначе замер оборвётся на вашей стороне.
Интегрируйте
Место таких вызовов — фоновая задача или ночное расписание, а не обработка пользовательского запроса.
Возможности API
Что приходит в ответе на один запрос
Четыре оценки
Производительность, доступность, лучшие практики и SEO по стобалльной шкале.
Лабораторные метрики
labMetrics — время до первой отрисовки, LCP, CLS, блокировка, интерактивность.
Данные посетителей
fieldData по странице и originFieldData по домену.
Узкие места
opportunities — что чинить, с выигрышем в миллисекундах.
Профиль устройства
strategy=mobile|desktop — считается и хранится раздельно.
Свежий замер
forceRefresh=true — когда оптимизацию выкатили только что.
Пакет до 20
batch — ключевые страницы сайта одним вызовом.
Swagger + CORS
Спецификация OpenAPI с примерами; удобно для браузерных инструментов.
Два набора метрик в одном ответе
Разные вопросы о странице. Складывать их в одно число нельзя
labMetrics — лаборатория |
fieldData — реальные посетители | |
|---|---|---|
| Как получается | Страница загружается в стандартизованном окружении в момент запроса | Статистика по посещениям живых людей за прошедший период |
| Что описывает | Один прогон в одинаковых для всех условиях — всегда первый визит | Распределение по устройствам, каналам и географии вашей аудитории |
| Когда обновляется | Немедленно: выкатили исправление — увидели результат | С задержкой: изменения проявятся, когда наберётся статистика |
| Для чего годится | Сравнение «до и после», поиск причины, контроль регрессий | Оценка реального положения дел и приоритизация работ |
| Когда пусто | Практически никогда | У малопосещаемой страницы — null, и это штатный ответ |
| Есть ли INP | Нет: некому нажимать. Вместо него — общее время блокировки | Да: живые люди действительно нажимают |
Что учесть при интеграции
Три особенности, которые ломают код молча
Ответ идёт десятки секунд
10–30 секунд — норма: страница действительно загружается браузером. Таймаут клиента ставьте не меньше 120 секунд. Синхронный вызов внутри обработки пользовательского запроса заблокирует его целиком — выносите замер в фоновую задачу или расписание.
Полевой блок бывает пустым
fieldData и originFieldData обнуляемы:
у страницы может не быть достаточной статистики посещений.
Это штатный ответ, а не ошибка. Обрабатывайте null
отдельной веткой, иначе получите падение на первой же нишевой странице.
Профили не сравнивают между собой
Мобильный замер идёт на характеристиках среднего телефона, и разница
с десктопным у одной страницы бывает в 30–40 пунктов. Храните и
сравнивайте результаты в пределах одного значения
strategy — иначе получите «улучшение», которого не было.
Нужна помощь с интеграцией?
Используйте Swagger ниже и примеры параметров. Для теста подойдут Postman, Thunder Client или curl — не забудьте поднять таймаут клиента.
Swagger документация API
Откройте спецификацию OpenAPI, чтобы проверить запросы и ответы API аудита сайта.
Почему выбирают наш API
Преимущества REST API аудита сайта для интеграции
Весь отчёт за один вызов
Оценки, метрики, полевые данные и узкие места приходят вместе. Собирать отчёт из нескольких запросов не нужно.
Готовый порядок работ
Узкие места отсортированы по выигрышу в миллисекундах — видно, что даст полторы секунды, а что сорок миллисекунд.
Платите за замеренное
Недоступная страница не тарифицируется, а в пакете счёт идёт построчно — только за адреса, по которым замер состоялся.
Честное разделение данных
Лабораторный замер и статистика посетителей лежат отдельными блоками и никогда не сводятся в одну цифру, которая не описывала бы ни то, ни другое.
Готовы подключить аудит сайта?
Поставьте ночной прогон ключевых страниц через API или замерьте одну страницу в GUI.