Cloudflare SQL API: проверьте чтение атрибутов в отчётах
Изменение introspection от 27 октября: что передать разработчику, как проверить пустой отчёт и сохранить прежнюю версию интеграции.
27 октября Cloudflare объявил новое имя параметра introspection: include_attributes; поле ответа — attributes. Прежние имена пока работают, но помечены устаревшими.
Кому это нужно
Вебмастерам с собственным техническим отчётом, который получает схему через Cloudflare SQL API, и разработчикам этого отчёта. Если вы только открываете готовую панель, сначала выясните, использует ли ваш подрядчик этот API. Новость не означает поломку всех отчётов и не требует менять рекламные кампании.
Что проверить
В документации SQL API отмечен как Beta. Обнаружение атрибутов учитывает последние семь дней данных аккаунта. Поэтому пустой список нельзя автоматически считать доказательством отсутствия событий за всё время.
Наша последовательность проверки
Найдите в коде клиента старые имена include_custom_attributes и custom_attributes. Сохраните рабочую версию. В тестовой копии согласованно замените параметр запроса и чтение ответа; одной замены адреса недостаточно. Сравните старый и новый разбор на одном сохранённом обезличенном ответе и проверьте результат на доступном наборе данных. Ключ доступа не добавляйте в рабочий лист или статью.
Два учебных примера
Первый: после изменения запроса фильтр отчёта стал пустым. Сохраните обезличенный ответ и проверьте, откуда клиент читает список. Если он продолжает искать старое поле, исправьте разбор в тестовой копии; не объявляйте потерю трафика по пустому интерфейсу. Второй: нужный атрибут встречался только в давней кампании. Отдельно проверьте период наблюдения и исходные данные. Не подставляйте ноль вместо неизвестного значения. Это сценарии проверки, а не результаты клиентов.
Карточка задачи разработчику
Владелец отчёта; аккаунт и набор данных без секретов; время проверки; прежнее поле; новое поле; обезличенный пример ответа; ожидаемый фильтр; фактический результат; способ возврата; решение и ответственный.
Когда завершать
Принимайте изменение, когда проверенный ответ корректно отображается, отсутствие данных явно обозначено, а прежняя версия сохранена. При расхождении остановите замену клиента и разберите причину. Не меняйте решения о качестве источника по одному техническому сбою.
Связь с партнёрской работой
Для работы в нашей платформе можно войти в кабинет AffiliateCore. Технические данные Cloudflare и подтверждение партнёрского результата — разные проверки; эту новость не следует воспринимать как анонс интеграции.
Первоисточники и дата проверки
Cloudflare changelog — 2026-10-27; Cloudflare SQL API: Datasets. 2026-10-28.