CMS для сайтов и приложений

С помощью CMS Gigma вы можете менять страницы, отдельные секции и навигацию без новой сборки сайта или выпуска приложения.

Gigma хранит контент и возвращает его в формате JSON. Ваш продукт сам выбирает макет и решает, что показать пользователю, если данные временно недоступны.

С чего начать

Опубликовать первый материал

Создайте страницу через API управления и получите её тем же запросом, который будет использовать сайт.

Быстрый старт CMS

Менять отдельные секции

Создайте блок с постоянным identifier, например home-hero, и получайте его независимо от остальных страниц.

Управление контентными блоками

Подключить навигацию

Создайте корневое меню, добавьте вложенные пункты и получите готовое дерево по slug.

Управление меню

Как проходит обновление контента

1. Ваш сервер создаёт или изменяет объект с Bearer сотрудника.
2. Gigma связывает объект с нужным Application.
3. Сайт запрашивает контент с App Token этого приложения.
4. Gigma возвращает страницу, блок, меню или рекламные слайды.
5. Сайт проверяет ответ и показывает контент пользователю.

Сохранённые изменения сразу доступны через API чтения. Отдельного шага публикации в этом сценарии нет.

Подготовка CMS

Если Application ещё нет, создайте приложение. В ответе сохраните application.id и application.token: это ID приложения и его App Token. Для чтения CMS склад не требуется.

Перед первым запросом подготовьте:

• Application и его ID;
• App Token для запросов сайта или приложения;
• Bearer сотрудника для API управления; для полного быстрого старта сотруднику нужно право edit-applications;
• актуальные ID типов страниц, блоков и файлов.

Быстрый старт создаёт страницу со slug gigma-shop-legal-offer. Проверьте её тем же App Token:

GET /api/counterparty/pages/gigma-shop-legal-offer HTTP/1.1
Host: api.gigma.ru
Token: <application_token>
Accept: application/json

Для другой страницы замените gigma-shop-legal-offer на её slug. Сравните page.slug с запрошенным значением, прежде чем показывать ответ пользователю.

Выберите задачу

• Чтобы пройти полный путь от создания до чтения, откройте Быстрый старт CMS.
• Чтобы создать, изменить или удалить страницу, откройте Управление страницами.
• Чтобы получить страницу по slug, откройте Получение страниц.
• Чтобы собрать баннер, текстовую секцию или дерево блоков, откройте Управление контентными блоками.
• Чтобы получить блок по постоянному ключу, откройте Получение контентных блоков.
• Чтобы создать и упорядочить навигацию, откройте Управление меню.
• Чтобы получить готовое дерево навигации, откройте Получение меню.
• Чтобы показать рекламный слайдер, откройте Рекламные слайды.

Изображения и документы загружайте через раздел Файлы и медиа.

Какие токены понадобятся

• App Token определяет Application и используется при чтении страниц, блоков, меню и слайдов.
• Bearer сотрудника используется на вашем сервере при создании, изменении и удалении контента. Возможности токена зависят от прав сотрудника.

Bearer сотрудника храните только на доверенном сервере. Не передавайте его в браузер, мобильное приложение или публичный JavaScript.

Надёжность и безопасность

Правила очистки HTML, проверки ссылок, обновления кэша и восстановления после сетевой ошибки собраны в разделе Что учесть при синхронизации. Они относятся ко всем объектам CMS и поэтому не повторяются на каждой странице справочника.

Другие сценарии

Для каталога, заказов и оплаты используйте Интернет-магазин и приложения. Для регулярных списаний и платного доступа используйте Сервис управления подписками.