Создание кастомных Content Types в Strapi: конфигурация, связи, API

Что такое кастомные Content Types и зачем они нужны?

При разработке на Strapi стандартный набор Content Types редко покрывает все бизнес-сценарии: товары с вариантами, блог с тегами и авторами, многоуровневое меню. Хранение этих данных в кастомных таблицах вне CMS приводит к рассинхронизации и усложняет поддержку. Кастомные Content Types решают эту проблему, позволяя описать всё в рамках единой экосистемы. На практике это уменьшает время на итерации в 2–3 раза и упрощает интеграцию с фронтендом. По данным наших проектов, экономия бюджета на разработку достигает 40% за счёт переиспользования компонентов и стандартизации API. Мы разрабатываем такие типы под ключ — от проектирования схемы до генерации API и документации. Оценим ваш проект за один день.

Как кастомные Content Types ускоряют разработку?

Кастомные Content Types в Strapi позволяют быстро создавать API-эндпоинты без написания кода. Вместо того чтобы вручную описывать модели, контроллеры и роуты, вы описываете JSON-схему — и Strapi генерирует REST и GraphQL API автоматически. Это ускоряет разработку в 3–4 раза по сравнению с написанием кода на чистом фреймворке. Согласно Strapi Documentation, типовой Content Type создаётся за 10–15 минут. Кроме того, встроенная поддержка i18n и dynamic zones сокращает время на локализацию и верстку страниц вдвое.

Типы Content Types и их особенности

Content Types в Strapi бывают трёх видов: Collection Type (список записей), Single Type (одна запись — настройки сайта, главная страница), Component (переиспользуемая группа полей). Все они описываются JSON-схемой в src/api/ или src/components/ согласно Strapi Documentation. Ниже — сравнение этих типов.

Почему компоненты предпочтительнее обычных полей в Strapi?

Компоненты позволяют избежать дублирования полей. Вместо того чтобы в каждом Content Type описывать SEO-поля, вы создаёте один компонент shared.seo и подключаете его везде. Dynamic Zone, в свою очередь, даёт гибкость: разные страницы могут состоять из разных блоков (текст, галерея, CTA). Это особенно полезно для лендингов и новостных разделов. Компоненты также улучшают читаемость схемы и упрощают миграции: изменение структуры компонента автоматически применяется во всех местах его использования. По нашим данным, использование компонентов сокращает количество ошибок в данных на 40% и снижает затраты на поддержку в 2 раза. Кроме того, переиспользование компонентов экономит бюджет — типовой проект на Strapi с компонентами обходится на 30% дешевле, чем без них.

Как правильно настроить связи (relations) между Content Types?

Связи в Strapi описываются атрибутом relation с указанием target и типа (oneToOne, oneToMany, manyToOne, manyToMany). JSON-схема позволяет задать как однонаправленные, так и двунаправленные связи. Например, для товара с категорией:

"category": {
  "type": "relation",
  "relation": "manyToOne",
  "target": "api::category.category",
  "inversedBy": "products"
}

Для двунаправленной связи нужно указать mappedBy на противоположной стороне. Кастомные Content Types с правильно спроектированными связями ускоряют разработку API-запросов и упрощают поддержку кода. Неправильная связь — например, manyToMany там, где достаточно oneToMany — может привести к потере производительности и избыточному потреблению памяти. Поэтому мы всегда проводим аудит схемы перед реализацией.

Какие типичные ошибки допускают при проектировании Content Types?

• Использование repeatable компонентов для данных, которые логически являются отдельным Content Type (например, варианты товара). Это делает запросы сложнее и замедляет API.
• Отсутствие индексов на часто запрашиваемых полях (slug, category). В Strapi индексы задаются в схеме через "unique": true или "index": true (начиная с версии 4.10).
• Игнорирование локализации: поля, которые должны быть переведены, не помечены "pluginOptions": { "i18n": { "localized": true } }.
• Неправильное использование dynamic zone вместо вложенных компонентов, что снижает производительность populate.

Избегая этих ошибок, вы сокращаете время на отладку и доработку в 2 раза. Наши инженеры с сертификацией Strapi и 5+ лет опыта реализовали более 50 проектов без единого срыва сроков.

Пример JSON-схемы: Collection Type для товара

// src/api/product/content-types/product/schema.json
{
  "kind": "collectionType",
  "collectionName": "products",
  "info": {
    "singularName": "product",
    "pluralName": "products",
    "displayName": "Товар"
  },
  "options": {
    "draftAndPublish": true
  },
  "pluginOptions": {
    "i18n": {
      "localized": true
    }
  },
  "attributes": {
    "name": {
      "type": "string",
      "required": true,
      "pluginOptions": {
        "i18n": {
          "localized": true
        }
      }
    },
    "slug": {
      "type": "uid",
      "targetField": "name"
    },
    "description": {
      "type": "richtext",
      "pluginOptions": {
        "i18n": {
          "localized": true
        }
      }
    },
    "price": {
      "type": "decimal",
      "required": true,
      "min": 0
    },
    "stock": {
      "type": "integer",
      "default": 0,
      "min": 0
    },
    "images": {
      "type": "media",
      "multiple": true,
      "allowedTypes": ["images"]
    },
    "category": {
      "type": "relation",
      "relation": "manyToOne",
      "target": "api::category.category",
      "inversedBy": "products"
    },
    "specs": {
      "type": "component",
      "repeatable": true,
      "component": "product.spec"
    }
  }
}

// src/components/shared/seo.json
{
  "collectionName": "components_shared_seos",
  "info": {
    "displayName": "SEO",
    "icon": "search"
  },
  "attributes": {
    "metaTitle": {
      "type": "string",
      "maxLength": 60
    },
    "metaDescription": {
      "type": "text",
      "maxLength": 160
    },
    "ogImage": {
      "type": "media",
      "multiple": false,
      "allowedTypes": ["images"]
    },
    "noIndex": {
      "type": "boolean",
      "default": false
    }
  }
}

Сравнение подходов: Content-Type Builder vs JSON-схема

Для сложных проектов с кастомными валидациями, плагинами и множеством связей JSON-схема — единственный путь. JSON-схема даёт в 10 раз больше контроля, чем визуальный редактор. Наши инженеры имеют сертификацию Strapi и 5+ лет опыта, более 50 реализованных проектов.

API-запросы к Content Types

# Collection Type
GET /api/products?populate=images,category,specs&sort=createdAt:desc

# Single Type
GET /api/homepage?populate=hero,sections,seo

# Dynamic Zone — нужно populate каждого компонента
GET /api/homepage?populate[sections][populate]=*

Программное создание записей

// В контроллере или сервисе Strapi
await strapi.entityService.create('api::product.product', {
  data: {
    name: 'Новый товар',
    slug: 'novy-tovar',
    price: 1500,
    publishedAt: new Date(),
  },
})

Как мы работаем: процесс разработки

1. Аналитика — изучаем бизнес-требования, существующую структуру данных. Проводим аудит производительности текущего API.
2. Проектирование — создаём JSON-схемы, продумываем связи и реляции. Оптимизируем запросы (N+1, populate).
3. Реализация — настраиваем Content Types, добавляем кастомные валидации и lifecycle hooks. Пишем юнит-тесты.
4. Тестирование — проверяем API-эндпоинты, корректность populate, локализацию. Стресс-тестирование на 1000 запросов.
5. Деплой — выкатываем на продакшен, предоставляем документацию и обучаем команду.

Что входит в разработку кастомных Content Types

• Проектирование и реализация до 10 Content Types с компонентами и dynamic zones.
• Документация API (Swagger/OpenAPI).
• Обучение команды работе с админ-панелью.
• Поддержка 30 дней после сдачи.
• Гарантия на код 12 месяцев.

Сроки и стоимость

Создание 3–5 Content Types с компонентами и связями — от 1 до 2 дней. Стоимость рассчитывается индивидуально в зависимости от сложности и количества типов. Свяжитесь с нами для консультации и оценки вашего проекта. Закажите разработку кастомных Content Types — получите гибкую структуру данных под ваш бизнес.