Strapi REST і GraphQL: налаштування та оптимізація

Уявіть: фронтенд потребує даних з кастомною вкладеністю — статті з авторами, категоріями, тегами та динамічними зонами. Без правильного налаштування API ви отримуєте N+1 запити, гігантські JSON-відповіді та падіння LCP. Наприклад, типовий запит на отримання статті з автором і категорією без оптимізації генерує 4 запити до БД, що збільшує TTFB до 2 секунд. Після налаштування — один запит і TTFB 200 мс. Ми оптимізували такі сценарії для 30+ проєктів за 6 років роботи. У цьому посібнику розберемо, як налаштувати REST і GraphQL у Strapi, уникнути типових помилок і прискорити API до 10 разів.

Чому варто використовувати REST і GraphQL разом?

REST API у Strapi працює «з коробки» — ідеально для простих списків і стандартних CRUD. GraphQL через плагін підключається за 5 хвилин і вирішує проблему overfetching. GraphQL зменшує об'єм переданих даних до 80% порівняно з REST при складних ієрархіях — це підтверджує наша практика. Ми комбінуємо їх: REST для публічних ендпоінтів, GraphQL для адмінки та внутрішніх інструментів. Оптимізація Strapi REST API та Strapi GraphQL — ключ до швидкодії. Порівняння можливостей — у таблиці.

Як налаштувати REST API?

Формат відповіді Strapi єдиний:

{
  "data": {
    "id": 1,
    "attributes": {
      "title": "Article",
      "slug": "article",
      "publishedAt": "..."
    }
  },
  "meta": {}
}

Для фільтрації, populate, пагінації та сортування використовуйте query-параметри. Приклад запиту з усіма можливостями:

GET /api/articles?filters[status][$eq]=published&filters[price][$gte]=100&populate=author,category&sort[0]=publishedAt:desc&pagination[page]=2&pagination[pageSize]=10&fields[0]=title,slug 

Підтримуються оператори: $eq, $ne, $lt, $in, $contains, $startsWith, $endsWith, $null, $notNull та їх регістровонезалежні варіанти з суфіксом i. Для зв'язків використовуйте populate — він може бути глибоким, але обмежте глибину через middleware strapi::populate-depth (рекомендуємо maxDepth: 3), щоб уникнути N+1.

Як підключити та кастомізувати GraphQL?

Встановіть плагін @strapi/plugin-graphql і додайте конфігурацію в config/plugins.js (endpoint, ліміти, вимкнення playground у production). Приклад GraphQL запиту на отримання статей із вкладеними даними:

query GetArticles($locale: I18NLocaleCode, $page: Int) {
  articles(
    locale: $locale
    pagination: { page: $page, pageSize: 10 }
    sort: "publishedAt:desc"
    filters: { publishedAt: { notNull: true } }
  ) {
    data {
      id
      attributes {
        title
        slug
        excerpt
        publishedAt
        cover {
          data {
            attributes {
              url
              alternativeText
            }
          }
        }
        category {
          data {
            attributes {
              name
              slug
            }
          }
        }
      }
    }
    meta {
      pagination {
        total
        pageCount
      }
    }
  }
}

Для кастомних резолверів використовуйте extensionService. Створіть поле featuredArticles, що повертає лише обрані статті:

// src/index.ts
export default {
  register({ strapi }) {
    const extensionService = strapi.plugin('graphql').service('extension')
    extensionService.use(({ nexus }) => ({
      types: [
        nexus.extendType({
          type: 'Query',
          definition(t) {
            t.field('featuredArticles', {
              type: 'ArticleEntityResponseCollection',
              resolve: async (_root, _args, context) => {
                const articles = await strapi.entityService.findMany(
                  'api::article.article',
                  {
                    filters: { featured: true },
                    populate: ['cover', 'category'],
                    sort: { publishedAt: 'desc' },
                    limit: 6,
                  }
                )
                return { data: articles }
              },
            })
          },
        }),
      ],
    }))
  },
}

Як підвищити продуктивність API?

Кешуйте важкі запити з Redis. Наприклад, для featured-articles:

const redis = new Redis(process.env.REDIS_URL)
const cachedFeatured = await redis.get('featured-articles')
if (cachedFeatured) return JSON.parse(cachedFeatured)
const articles = await strapi.entityService.findMany(...)
await redis.setex('featured-articles', 300, JSON.stringify(articles))

Типова помилка — N+1 запити при агресивному populate. Якщо використовувати populate=*, Strapi виконує окремі запити до БД для кожного зв'язку. Обмеження глибини через middleware strapi::populate-depth і кешування Redis усувають цю проблему. Добре налаштований GraphQL у Strapi працює до 5 разів швидше за REST для складних запитів із багатьма зв'язками.

Додатково використовуйте Varnish або CDN для кешування відповідей публічних ендпоінтів. Порівняння стратегій кешування — у другій таблиці.

Як оптимізувати Strapi API: покроковий план

1. Аналіз поточних запитів. Використовуйте вбудований логер Strapi або сторонні інструменти (Kibana) для виявлення повільних ендпоінтів.
2. Налаштування populate-depth. Встановіть middleware strapi::populate-depth з maxDepth: 3 у конфігурації.
3. Впровадження кешування Redis. Кешуйте результати важких запитів з TTL 300 секунд — це знижує навантаження на БД до 10 разів.
4. Перехід на GraphQL для складних зв'язків. Якщо фронтенд запитує вкладені дані, використовуйте GraphQL — він зменшує об'єм переданих даних до 80%.
5. Моніторинг та ітерація. Регулярно перевіряйте продуктивність через Strapi audit logs і коригуйте налаштування.

Що входить у налаштування API під ключ?

• конфігурація REST та/або GraphQL з урахуванням навантаження;
• кастомні резолвери та мідлвари;
• оптимізація populate та кешування (Redis, Varnish);
• налаштування прав доступу та ролей;
• документація (Postman-колекція, опис ендпоінтів);
• навчання команди (1–2 сесії);
• підтримка 2 тижні після здачі.

Строки та вартість

Налаштування GraphQL плагіна, кастомних резолверів та оптимізація запитів — від 2 до 5 днів. Вартість налаштування API від $500 до $2000 залежно від складності. Правильне налаштування кешування може скоротити витрати на серверні потужності до 40%, а середня економія бюджету на інфраструктуру замовників складає 30%. Маємо 6-річний досвід, понад 30 успішних проектів, надаємо гарантію на налаштування — 30 днів безкоштовної підтримки. Замовте консультацію, щоб обговорити деталі вашого API. Отримайте консультацію — зв'яжіться з нами.

Джерело: офіційна документація Strapi по GraphQL — https://docs.strapi.io/dev-docs/plugins/graphql