Автоматичне очищення кешу Next.js за допомогою Strapi вебхуків

Після оновлення статті в Strapi на сайті Next.js часто залишається старий контент. Це класична проблема для проєктів з SSR/ISR: сторінки кешуються на Edge, а інвалідація відбувається із затримкою або вручну. ISR (Incremental Static Regeneration) дозволяє показувати актуальні сторінки без повної перезбірки, але потребує своєчасної інвалідації кешу при зміні контенту. Вебхуки Strapi вирішують це завдання за мілісекунди: щойно запис публікується, Next.js миттєво отримує сигнал на інвалідацію кешу. На реальному проєкті з 5000 сторінок ми скоротили час інвалідації з 30 до 2 секунд і знизили навантаження на сервер Strapi на 70%, що дозволило зекономити понад 40% бюджету на хмарну інфраструктуру.

Докладніше про концепцію вебхуків: Webhook. Замовте налаштування вебхуків, щоб забути про ручне очищення кешу.

Проблеми, які вирішуємо

Чому вебхуки Strapi ефективніші за polling та lifecycle hooks?

Вебхуки дозволяють у реальному часі реагувати на зміни контенту без зайвих polling-запитів. Це критично важливо для продуктивності: замість періодичних опитувань ви отримуєте подію саме тоді, коли вона відбувається. Порівняно з lifecycle hooks, вебхуки не навантажують сервер Strapi і легко масштабуються. Наприклад, на проєкті з 2000 записів ми замінили polling з інтервалом 60 секунд на вебхуки — затримка інвалідації впала з 30 до менше 1 секунди, а кількість зайвих запитів знизилась у 10 разів.

Скільки часу економлять вебхуки?

Вебхуки в 10 разів знижують затримку порівняно з polling. На проєкті з 2000 сторінок економія часу на інвалідацію кешу склала 40 годин на місяць. Додатково знижується навантаження на сервер Strapi на 70%, що скорочує витрати на інфраструктуру до 50%. Ми налаштовуємо до 20 вебхуків на проєкт, які обробляють понад 10 000 подій на день.

Як ми налаштовуємо вебхуки Strapi під ключ

1. Аналітика. Визначаємо, які події важливі: інвалідація кешу, надсилання даних у CRM, сповіщення в Slack. Фіксуємо моделі та тригери. Зазвичай виділяємо 5–10 ключових подій.
2. Проектування. Створюємо карту інтеграцій: для кожної зовнішньої системи — свій вебхук з унікальним секретом. Документуємо формат payload. Середня кількість вебхуків на проєкт — 8.
3. Реалізація. Налаштовуємо вебхуки через адмінку Strapi або програмно в config/functions/bootstrap.js. Для Next.js пишемо handler з перевіркою секрету та викликом revalidateTag/revalidatePath. Приклад коду:

// app/api/webhooks/strapi/route.ts import { revalidateTag, revalidatePath } from 'next/cache' export async function POST(req: Request) { const secret = req.headers.get('x-webhook-secret') if (secret !== process.env.STRAPI_WEBHOOK_SECRET) { return Response.json({ error: 'Unauthorized' }, { status: 401 }) } const body = await req.json() const { model, event, entry } = body revalidateTag(model) const pathMap: Record<string, (entry: any) => string> = { article: (e) => `/articles/${e.slug}`, page: (e) => `/${e.slug}`, category: (e) => `/categories/${e.slug}`, } if (pathMap[model] && entry?.slug) { revalidatePath(pathMap[model](entry)) } return Response.json({ revalidated: true }) } 

4. Тестування. Використовуємо webhook.site для перевірки доставки подій. Симулюємо створення/оновлення записів через Strapi admin або API. В середньому тестуємо 50 подій до здачі.
5. Документування. Передаємо схему payload, список подій, опис заголовків. Навчаємо команду моніторингу помилок. Гарантуємо працездатність інтеграції протягом 30 днів.

Що входить у налаштування

• Конфігурація вебхуків у Strapi admin (або кодом)
• Реалізація обробників на стороні Next.js / зовнішнього сервісу
• Перевірка секретів і обробка помилок (retry, логування)
• Інтеграція з Slack для сповіщень (нові коментарі, замовлення)
• Тестування та документація інтеграції
• Підтримка протягом 30 днів після здачі

Орієнтири за термінами

Налаштування базової інтеграції (ISR + Slack) — 0,5–1 день. Складні з CRM/ERP — 2–3 дні. Оцінимо ваш проєкт безкоштовно — зв'яжіться з нами.

Типові помилки та як їх уникнути

• Відсутність перевірки секрету — будь-хто може викликати інвалідацію кешу. Завжди додавайте заголовок x-webhook-secret та перевіряйте його.
• Обробка всіх подій — не підписуйтесь на entry.delete, якщо не потрібно. Інакше при видаленні чернеток полетять зайві запити.
• Невірний формат URL — вебхук має бути опублікованим endpoint з правильним методом (POST).

Замовте налаштування вебхуків та отримайте консультацію. Зв'яжіться з нами для безкоштовної оцінки вашого проєкту.