Настройка 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 для админки и внутренних инструментов. Сравнение возможностей — в таблице.

Как настроить 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 дней. Стоимость рассчитывается индивидуально — пришлите бриф, и мы оценим ваш проект. Правильная настройка кэширования может сократить расходы на серверные мощности до 40%, а средняя экономия бюджета на инфраструктуру заказчиков составляет 30%. Закажите консультацию, чтобы обсудить детали вашего API. Получите консультацию — свяжитесь с нами.

Источник: официальная документация Strapi по GraphQL — https://docs.strapi.io/dev-docs/plugins/graphql