Gigma

Страницы и публикации

Страницы подходят для новостей, статей, справочных материалов и других публикаций, которые должны обновляться без релиза frontend. Ответ содержит HTML в поле content; перед выводом применяйте правила безопасного рендеринга вашего приложения.

Все страницы списка ограничены текущим Application.

Получение типов страниц

Метод
GET
URL
https://api.gigma.ru/api/counterparty/page_types
Авторизация
App Token
Headers
Token: {application_token}
Успешный ответ
200

Ответ

{
    "items": [
        {
            "id": 1,
            "name": "Страница",
            "photo": null,
            "created_at": "2026-08-15T10:00:00+00:00"
        }
    ],
    "itemsCount": 1
}

Используйте id из этого ответа как page_type_id. Не фиксируйте справочные ID по примеру.

Получение списка страниц

Метод
GET
URL
https://api.gigma.ru/api/counterparty/pages
Авторизация
App Token
Headers
Token: {application_token}
Успешный ответ
200

Параметры запроса

  • page_type_id (integer, опционально) — тип страницы;
  • query (string, опционально) — поиск по заголовку, описанию и HTML-содержимому, от 3 символов;
  • order_by (string, опционально) — date_asc, date_desc, popularity_asc или popularity_desc;
  • page (integer, опционально) — номер страницы, по умолчанию 1;
  • per_page (integer, опционально) — размер страницы, по умолчанию 10.

Параметр application_id проходит validation, но текущий controller его не использует: контекст всегда определяется App Token.

Пример запроса

GET /api/counterparty/pages?page_type_id=3&query=интеграция&order_by=date_desc&page=1&per_page=10 HTTP/1.1
Host: api.gigma.ru
Token: <application_token>
Accept: application/json

Ответ

{
    "pages": {
        "current_page": 1,
        "data": [
            {
                "id": 101,
                "slug": "integration-guide",
                "title": "Как подключить сервис",
                "description": "Краткое описание",
                "preview": null,
                "content": "<p>Содержимое страницы</p>",
                "views_count": 12,
                "author": null,
                "tags": [],
                "created_at": "2026-08-15T10:00:00+00:00"
            }
        ],
        "per_page": 10,
        "total": 1,
        "last_page": 1
    }
}

Получение страницы по slug

Метод
GET
URL
https://api.gigma.ru/api/counterparty/pages/{slug}
Авторизация
App Token
Headers
Token: {application_token}
Успешный ответ
200

Пример запроса

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

Ответ

{
    "page": {
        "id": 101,
        "slug": "integration-guide",
        "title": "Как подключить сервис",
        "description": "Краткое описание",
        "preview": null,
        "content": "<p>Содержимое страницы</p>",
        "views_count": 13,
        "author": null,
        "tags": [],
        "created_at": "2026-08-15T10:00:00+00:00"
    }
}

Backend увеличивает views_count не чаще одного раза за 10 минут для одного IP и страницы.

Текущее ограничение runtime: при неизвестном slug controller может вернуть резервную страницу вместо 404. До исправления backend сравнивайте page.slug с запрошенным значением и не показывайте резервный контент как найденную публикацию.

© 2026 Gigma