REST API афиши

Те же данные, что на сайте: события, сеансы, справочники и подбор по фразе. Ключ не нужен.

Демо-данныеСобытия условные: они показывают, как работает афиша.

На этой странице

Как подключить афишу на сайте министерства

Три шага, и на странице министерства появляется живая афиша. Действующие системы сайта не меняются: виджет только читает открытый API афиши.

1
Вставьте строку
Добавьте её в то место страницы, где должна стоять афиша. Подойдёт любой редактор сайта, который разрешает вставку HTML.
Строка для вставки
```
<script src="https://89-125-129-170.nip.io/widget.js" data-city="ufa" data-limit="5" data-theme="light" data-lang="ru" async></script>
```
На сайте запрещены сторонние скрипты? Возьмите вариант с iframe: он показывает тот же список.
Вариант с iframe
```
<iframe src="https://89-125-129-170.nip.io/embed?city=ufa&amp;limit=5&amp;theme=light&amp;lang=ru" title="Афиша событий" loading="lazy" width="100%" height="720" style="border:0"></iframe>
```

Выберите параметры

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

Открыть конфигуратор

Атрибуты тега script
Атрибут	Описание
`data-city`	Код города: `ufa`, `sterlitamak`, `salavat` и другие. Несколько городов через запятую. Без атрибута показывается вся республика.
`data-category`	Код категории п. 8.1: `concert`, `performance`, `exhibition`, `festival`, `cinema`, `excursion`, `other`.
`data-period`	Период: `today`, `tomorrow`, `weekend` или `week`. Без атрибута показываются все ближайшие события.
`data-height`	Высота в пикселях, от 240 до 1600. Длинный список прокручивается внутри виджета, страница не прыгает.
`data-limit`

Проверьте
Откройте страницу. В блоке должны появиться ближайшие события с датой, площадкой, ценой и статусом. Если блок пуст, проверьте адрес скрипта и откройте GET /api/v1/health: ответ "status": "ok" значит, что API доступен.
Проверить API (откроется в новой вкладке)

Без вмешательства в действующие системы

Доступ к серверу и базе сайта не нужен: хватает одной строки в разметке страницы.
Виджет не ставит cookie и не собирает данные посетителей.
Стили страницы и виджета изолированы друг от друга: разметка живёт в Shadow DOM.
Чтобы убрать афишу, достаточно удалить строку.

Общие правила

Базовый адрес

https://89-125-129-170.nip.io/api/v1

Адрес подставлен тот, по которому открыта эта страница. Все примеры ниже рабочие: их можно копировать как есть.

Доступ: Ключ не нужен. API только читает данные и не использует cookie.
Формат: JSON в UTF-8. Имена полей в snake_case.
Время: Все события идут по поясу Asia/Yekaterinburg (UTC+5). «Сегодня», «завтра» и «выходные» считаются в этом поясе. В ответе списка есть reference_date: дата, от которой сервер считал периоды.
Деньги: Цена в рублях, как в п. 8.1 ТЗ: price_min, price_max и is_free. 0 значит бесплатно, null значит «цена не указана». В параметрах запроса цена тоже в рублях.
Языки: Подписи справочников приходят на двух языках: { "ru": "Уфа", "ba": "Өфө" }. Названия событий приходят на языке источника. Башкирское название лежит в title_ba, если оно есть.
Кэш: Ответы с событиями идут с Cache-Control: no-store: даты и признак is_past зависят от текущего времени. Справочники можно держать в кэше 5 минут.

Три правила достоверности

Неизвестное не считается подходящим. Событие без цены не проходит фильтр price_max, событие без возрастной метки не проходит фильтр age. Такие события не теряются молча: их число лежит в hidden_unknown_price и .

Методы

Адрес	Что отдаёт	Выполнить запрос
GET`/api/v1/events`	Список событий с фильтрами	Попробовать (откроется в новой вкладке)
GET`/api/v1/events/{id}`	Карточка события со всеми сеансами	Попробовать (откроется в новой вкладке)
GET`/api/v1/facets`	Число событий по городам и категориям	Попробовать (откроется в новой вкладке)
GET

Список событий

GET/api/v1/eventsПопробовать (откроется в новой вкладке)

Список событий с фильтрами, сортировкой, счётчиками и вариантами ослабить условия. Все параметры необязательные. Списки передаются через запятую: city=ufa,salavat.

Параметры
Параметр	Тип	Описание
`city`	список	Города: `ufa`, `sterlitamak`, `salavat`, `neftekamsk`, `oktyabrsky`, `beloretsk`, `sibay`, `kumertau`.
`category`	список	Категории п. 8.1: `concert`, `performance`, `exhibition`, `festival`, `cinema`, `excursion`, `other`.
`date`	строка	Готовый период: `today`, `tomorrow`, `weekend`, `week`. Или одна дата `ГГГГ-ММ-ДД`. Нельзя сочетать с `date_from` и `date_to`.

Карточка события

GET/api/v1/events/{id}Попробовать (откроется в новой вкладке)

Карточка события со всеми сеансами, включая прошедшие, отменённые и перенесённые. В списке таких сеансов нет: там только те, что прошли условия.

Запрос: curl

curl "https://89-125-129-170.nip.io/api/v1/events/fc2d50a3-de94-5e4a-a427-33c6aa08e2d4"

Ответ 200строк: 79

{
  "id": "fc2d50a3-de94-5e4a-a427-33c6aa08e2d4",
  "title": "Выставка графики",
  "normalized_title": "выставка графики",
  "category": "exhibition",
  "tags": [],
  "date_start": "2026-11-13T00:00:00+05:00",
  "date_end": "2026-12-02T00:00:00+05:00",
  "duration_min": null,
  "city": "Уфа",
  "venue": "Башкирский государственный художественный музей им. М. В. Нестерова",
  "address": null,
  "lat": null,
  "lon": null,
  "description": "Рисунок, акварель и печатная графика. Спокойная выставка, на которую хватит часа.",
  "price_min": 300,
  "price_max": 300,
  "is_free": false,
  "age_limit": 0,
  "language": null,
  "org_link": "http://89.125.129.170/about#demo",
  "source_url": "http://89.125.129.170/about#demo",
  "source_type": "manual",
  "source_hash": "4310b5ea74ac0ab51ce6e87a5e59fe47b1aa415c9042bd806da38e9267c36aab",
  "verified_at": "2026-11-14T07:54:57+05:00",
  "confidence": 0.95,
  "status": "published",
  "dedup_key": "выставка графики|2026-11-13|ven-ufa-nesterov",
  "created_at": "2026-11-07T07:54:57+05:00",
  "updated_at": "2026-11-14T07:54:57+05:00",
  "city_id": "ufa",
  "venue_id": "ven-ufa-nesterov",
  "time_precision": "date",
  "kind": "exhibition",
  "popularity": 70,
  "organizer": null,
  "image": "/images/events/exhibition-1.webp",
  "synthetic": true,
  "sources": [
    {
      "source_url": "http://89.125.129.170/about#demo",
      "source_type": "manual",
      "source_hash": "4310b5ea74ac0ab51ce6e87a5e59fe47b1aa415c9042bd806da38e9267c36aab",
      "verified_at": "2026-11-14T07:54:57+05:00",
      "title": "Демо-источник: афиша площадки"
    },
    {
      "source_url": "http://89.125.129.170/about#demo",
      "source_type": "page",
      "source_hash": "b7f273e50325369d1da551fd3a1b46adad813a53413ed7f95ca9afc256c90ce1",
      "verified_at": "2026-11-14T07:54:57+05:00",
      "title": "Демо-источник: страница организатора"
    }
  ],
  "occurrences": [
    {
      "id": "occ_demo_e1_1",
      "date_start": "2026-11-13T00:00:00+05:00",
      "date_end": "2026-12-02T00:00:00+05:00",
      "time_precision": "date",
      "status": "scheduled",
      "status_verified": true,
      "availability": "available",
      "is_past": false
    }
  ],
  "offers": [
    {
      "price": 300,
      "is_free": false,
      "audience": "adult"
    },
    {
      "price": 150,
      "is_free": false,
      "audience": "reduced"
    }
  ]
}

GET/api/v1/facetsПопробовать (откроется в новой вкладке)

Число событий по городам, категориям, возрастным меткам и виду цены. Принимает те же параметры, что список событий. Без параметров считает по всему каталогу.

Запрос: curl

curl "https://89-125-129-170.nip.io/api/v1/facets?date=weekend&audience=kids"

Ответ 200строк: 182

{
  "cities": [
    {
      "id": "ufa",
      "name": {
        "ru": "Уфа",
        "ba": "Өфө"
      },
      "count": 2
    },
    {
      "id": "sterlitamak",
      "name": {
        "ru": "Стерлитамак",
        "ba": "Стәрлетамаҡ"
      },
      "count": 1
    },
    {
      "id": "salavat",
      "name": {
        "ru": "Салават",
        "ba": "Салауат"
      },
      "count": 0
    },
    {
      "id": "neftekamsk",
      "name": {
        "ru": "Нефтекамск",
        "ba": "Нефтекама"
      },
      "count": 0
    },
    {
      "id": "oktyabrsky",
      "name": {
        "ru": "Октябрьский",
        "ba": "Октябрьский"
      },
      "count": 1
    },
    {
      "id": "beloretsk",
      "name": {
        "ru": "Белорецк",
        "ba": "Белорет"
      },
      "count": 2
    },
    {
      "id": "sibay",
      "name": {
        "ru": "Сибай",
        "ba": "Сибай"
      },
      "count": 0
    },
    {
      "id": "kumertau",
      "name": {
        "ru": "Кумертау",
        "ba": "Күмертау"
      },
      "count": 0
    }
  ],
  "categories": [
    {
      "id": "concert",
      "name": {
        "ru": "Концерты",
        "ba": "Концерттар"
      },
      "count": 0
    },
    {
      "id": "performance",
      "name": {
        "ru": "Спектакли",
        "ba": "Спектаклдәр"
      },
      "count": 0
    },
    {
      "id": "exhibition",
      "name": {
        "ru": "Выставки",
        "ba": "Күргәҙмәләр"
      },
      "count": 6
    },
    {
      "id": "festival",
      "name": {
        "ru": "Фестивали",
        "ba": "Фестивалдәр"
      },
      "count": 0
    },
    {
      "id": "cinema",
      "name": {
        "ru": "Кино",
        "ba": "Кино"
      },
      "count": 0
    },
    {
      "id": "excursion",
      "name": {
        "ru": "Экскурсии",
        "ba": "Экскурсиялар"
      },
      "count": 0
    },
    {
      "id": "other",
      "name": {
        "ru": "Другое",
        "ba": "Башҡа"
      },
      "count": 0
    }
  ],
  "age_ratings": [
    {
      "id": "0+",
      "name": {
        "ru": "0+",
        "ba": "0+"
      },
      "count": 5
    },
    {
      "id": "6+",
      "name": {
        "ru": "6+",
        "ba": "6+"
      },
      "count": 1
    },
    {
      "id": "12+",
      "name": {
        "ru": "12+",
        "ba": "12+"
      },
      "count": 0
    },
    {
      "id": "16+",
      "name": {
        "ru": "16+",
        "ba": "16+"
      },
      "count": 0
    },
    {
      "id": "18+",
      "name": {
        "ru": "18+",
        "ba": "18+"
      },
      "count": 0
    },
    {
      "id": "unknown",
      "name": {
        "ru": "Возраст не указан",
        "ba": "Йәше күрһәтелмәгән"
      },
      "count": 0
    }
  ],
  "price": {
    "free": 2,
    "paid": 4,
    "unknown": 0
  },
  "total": 6
}

Справочники

GET/api/v1/dictionariesПопробовать (откроется в новой вкладке)

Справочники с подписями на русском и башкирском: категории, города, возрастные метки, статусы, виды цены, сортировки, готовые периоды. Поле tone подсказывает цвет плашки: positive, warning, negative, neutral.

Запрос: curl

curl "https://89-125-129-170.nip.io/api/v1/dictionaries"

Ответ 200строк: 448

{
  "timezone": "Asia/Yekaterinburg",
  "currency": "RUB",
  "categories": [
    {
      "id": "concert",
      "name": {
        "ru": "Концерты",
        "ba": "Концерттар"
      },
      "name_one": {
        "ru": "Концерт",
        "ba": "Концерт"
      }
    },
    {
      "id": "performance",
      "name": {
        "ru": "Спектакли",
        "ba": "Спектаклдәр"
      },
      "name_one": {
        "ru": "Спектакль",
        "ba": "Спектакль"
      }
    },
    {
      "id": "exhibition",
      "name": {
        "ru": "Выставки",
        "ba": "Күргәҙмәләр"
      },
      "name_one": {
        "ru": "Выставка",
        "ba": "Күргәҙмә"
      }
    },
    {
      "id": "festival",
      "name": {
        "ru": "Фестивали",
        "ba": "Фестивалдәр"
      },
      "name_one": {
        "ru": "Фестиваль",
        "ba": "Фестиваль"
      }
    },
    {
      "id": "cinema",
      "name": {
        "ru": "Кино",
        "ba": "Кино"
      },
      "name_one": {
        "ru": "Кинопоказ",
        "ba": "Кино"
      }
    },
    {
      "id": "excursion",
      "name": {
        "ru": "Экскурсии",
        "ba": "Экскурсиялар"
      },
      "name_one": {
        "ru": "Экскурсия",
        "ba": "Экскурсия"
      }
    },
    {
      "id": "other",
      "name": {
        "ru": "Другое",
        "ba": "Башҡа"
      },
      "name_one": {
        "ru": "Другое",
        "ba": "Башҡа"
      }
    }
  ],
  "cities": [
    {
      "slug": "ufa",
      "name": {
        "ru": "Уфа",
        "ba": "Өфө"
      },
      "name_in": {
        "ru": "в Уфе",
        "ba": "Өфөлә"
      },
      "lat": 54.74,
      "lon": 55.97
    },
    {
      "slug": "sterlitamak",
      "name": {
        "ru": "Стерлитамак",
        "ba": "Стәрлетамаҡ"
      },
      "name_in": {
        "ru": "в Стерлитамаке",
        "ba": "Стәрлетамаҡта"
      },
      "lat": 53.63,
      "lon": 55.95
    },
    {
      "slug": "salavat",
      "name": {
        "ru": "Салават",
        "ba": "Салауат"
      },
      "name_in": {
        "ru": "в Салавате",
        "ba": "Салауатта"
      },
      "lat": 53.36,
      "lon": 55.93
    },
    {
      "slug": "neftekamsk",
      "name": {
        "ru": "Нефтекамск",
        "ba": "Нефтекама"
      },
      "name_in": {
        "ru": "в Нефтекамске",
        "ba": "Нефтекамала"
      },
      "lat": 56.09,
      "lon": 54.25
    },
    {
      "slug": "oktyabrsky",
      "name": {
        "ru": "Октябрьский",
        "ba": "Октябрьский"
      },
      "name_in": {
        "ru": "в Октябрьском",
        "ba": "Октябрьскийҙа"
      },
      "lat": 54.48,
      "lon": 53.47
    },
    {
      "slug": "beloretsk",
      "name": {
        "ru": "Белорецк",
        "ba": "Белорет"
      },
      "name_in": {
        "ru": "в Белорецке",
        "ba": "Белоретта"
      },
      "lat": 53.96,
      "lon": 58.4
    },
    {
      "slug": "sibay",
      "name": {
        "ru": "Сибай",
        "ba": "Сибай"
      },
      "name_in": {
        "ru": "в Сибае",
        "ba": "Сибайҙа"
      },
      "lat": 52.72,
      "lon": 58.67
    },
    {
      "slug": "kumertau",
      "name": {
        "ru": "Кумертау",
        "ba": "Күмертау"
      },
      "name_in": {
        "ru": "в Кумертау",
        "ba": "Күмертауҙа"
      },
      "lat": 52.77,
      "lon": 55.78
    }
  ],
  "age_ratings": [
    {
      "id": "0+",
      "min_age": 0,
      "label": {
        "ru": "0+",
        "ba": "0+"
      }
    },
    {
      "id": "6+",
      "min_age": 6,
      "label": {
        "ru": "6+",
        "ba": "6+"
      }
    },
    {
      "id": "12+",
      "min_age": 12,
      "label": {
        "ru": "12+",
        "ba": "12+"
      }
    },
    {
      "id": "16+",
      "min_age": 16,
      "label": {
        "ru": "16+",
        "ba": "16+"
      }
    },
    {
      "id": "18+",
      "min_age": 18,
      "label": {
        "ru": "18+",
        "ba": "18+"
      }
    }
  ],
  "statuses": [
    {
      "id": "scheduled",
      "label": {
        "ru": "Состоится",
        "ba": "Буласаҡ"
      },
      "tone": "positive"
    },
    {
      "id": "cancelled",
      "label": {
        "ru": "Отменён",
        "ba": "Юҡҡа сығарылған"
      },
      "tone": "negative"
    },
    {
      "id": "postponed",
      "label": {
        "ru": "Перенесён, дата уточняется",
        "ba": "Кисектерелгән, көнө асыҡлана"
      },
      "tone": "warning"
    },
    {
      "id": "rescheduled",
      "label": {
        "ru": "Перенесён на новую дату",
        "ba": "Яңы көнгә күсерелгән"
      },
      "tone": "warning"
    },
    {
      "id": "unknown",
      "label": {
        "ru": "Статус не подтверждён",
        "ba": "Статусы раҫланмаған"
      },
      "tone": "neutral"
    }
  ],
  "display_statuses": [
    {
      "id": "scheduled",
      "label": {
        "ru": "Состоится",
        "ba": "Буласаҡ"
      },
      "tone": "positive"
    },
    {
      "id": "cancelled",
      "label": {
        "ru": "Отменён",
        "ba": "Юҡҡа сығарылған"
      },
      "tone": "negative"
    },
    {
      "id": "postponed",
      "label": {
        "ru": "Перенесён, дата уточняется",
        "ba": "Кисектерелгән, көнө асыҡлана"
      },
      "tone": "warning"
    },
    {
      "id": "rescheduled",
      "label": {
        "ru": "Перенесён",
        "ba": "Күсерелгән"
      },
      "tone": "warning"
    },
    {
      "id": "sold_out",
      "label": {
        "ru": "Билеты кончились",
        "ba": "Билеттар бөткән"
      },
      "tone": "neutral"
    },
    {
      "id": "unverified",
      "label": {
        "ru": "Статус не подтверждён",
        "ba": "Статусы раҫланмаған"
      },
      "tone": "neutral"
    }
  ],
  "availability": [
    {
      "id": "available",
      "label": {
        "ru": "Билеты есть",
        "ba": "Билеттар бар"
      },
      "tone": "positive"
    },
    {
      "id": "sold_out",
      "label": {
        "ru": "Билеты кончились",
        "ba": "Билеттар бөткән"
      },
      "tone": "neutral"
    },
    {
      "id": "unknown",
      "label": {
        "ru": "Наличие билетов не подтверждёнo",
        "ba": "Билеттар барлығы раҫланмаған"
      },
      "tone": "neutral"
    }
  ],
  "price_kinds": [
    {
      "id": "free",
      "label": {
        "ru": "Бесплатно",
        "ba": "Бушлай"
      }
    },
    {
      "id": "from",
      "label": {
        "ru": "Платно",
        "ba": "Түләүле"
      }
    },
    {
      "id": "unknown",
      "label": {
        "ru": "Цена не указана",
        "ba": "Хаҡы күрһәтелмәгән"
      }
    }
  ],
  "offer_audiences": [
    {
      "id": "adult",
      "label": {
        "ru": "Взрослый",
        "ba": "Өлкәндәр өсөн"
      }
    },
    {
      "id": "child",
      "label": {
        "ru": "Детский",
        "ba": "Балалар өсөн"
      }
    },
    {
      "id": "reduced",
      "label": {
        "ru": "Льготный",
        "ba": "Ташламалы"
      }
    }
  ],
  "sorts": [
    {
      "id": "date",
      "label": {
        "ru": "Сначала ближайшие",
        "ba": "Башта яҡындағылары"
      }
    },
    {
      "id": "price",
      "label": {
        "ru": "Сначала дешевле",
        "ba": "Башта арзаныраҡтары"
      }
    },
    {
      "id": "popularity",
      "label": {
        "ru": "Сначала популярные",
        "ba": "Башта популярҙары"
      }
    }
  ],
  "date_presets": [
    {
      "id": "today",
      "label": {
        "ru": "Сегодня",
        "ba": "Бөгөн"
      }
    },
    {
      "id": "tomorrow",
      "label": {
        "ru": "Завтра",
        "ba": "Иртәгә"
      }
    },
    {
      "id": "weekend",
      "label": {
        "ru": "На выходных",
        "ba": "Ял көндәрендә"
      }
    },
    {
      "id": "week",
      "label": {
        "ru": "На этой неделе",
        "ba": "Ошо аҙнала"
      }
    }
  ]
}

Подбор по фразе

POST/api/v1/assistant/query

Подбор событий по свободной фразе. Ассистент превращает фразу в условия, условия проверяет код по полям событий. Событий, которых нет в каталоге, ассистент не называет.

В прототипе фразу разбирают правила без языковой модели: в ответе стоит "engine": "rules-mock-v1". Форма запроса и ответа та же, что будет у ассистента на языковой модели. Запросы понимаются на русском языке.

Сервер не хранит состояние диалога. Клиент присылает прежние условия в поле previous и получает в ответе новое полное состояние в поле constraints.

Тело запроса

Поле	Тип	Описание
`message`	строка	Фраза пользователя, до 500 знаков. Нужна фраза или `patch`.
`previous`	объект	Условия `{ hard, soft }` из прошлого ответа: с ними диалог продолжается.
`patch`	объект	Правка условий без текста: `{ reset, set: { hard, soft }, unset: ["hard.date"] }`. Так работают чипы и варианты из `relaxations`.
`answering`	строка	На какой вопрос отвечает пользователь: значение `clarify.code` из прошлого ответа. Помогает понять короткий ответ вроде «7».
`limit`	целое	Сколько событий вернуть, от 1 до 12. По умолчанию 6.

Служебные методы

GET/api/v1/healthПопробовать (откроется в новой вкладке)

GET /api/v1/health проверяет, что API отвечает, и сообщает, откуда берутся данные.

Запрос: curl

curl "https://89-125-129-170.nip.io/api/v1/health"

Ответ 200строк: 13

{
  "status": "ok",
  "checks": {
    "database": "ok",
    "model": "ok",
    "assistant": "ok"
  },
  "version": "1.0.0",
  "data": "postgres",
  "events": 41,
  "time": "2026-11-15T22:42:32+05:00",
  "timezone": "Asia/Yekaterinburg"
}

GET/api/v1Попробовать (откроется в новой вкладке)

Ошибки

Ошибка приходит с кодом HTTP и телом одного вида. Сообщение написано для человека: его можно показать как есть. В details перечислены все поля, которые не прошли проверку.

Попробовать

Запрос: curl

curl "https://89-125-129-170.nip.io/api/v1/events?city=moscow"

Ответ 400строк: 11

{
  "code": "validation_error",
  "message": "Проверьте параметры поиска событий",
  "details": [
    {
      "field": "city",
      "message": "Неизвестный город «moscow». Допустимые: ufa, sterlitamak, salavat, neftekamsk, oktyabrsky, beloretsk, sibay, kumertau"
    }
  ],
  "request_id": "req_20e89f73f353414db607"
}

error.code	Код HTTP	Когда
`validation_error`	400	Параметр не прошёл проверку.

CORS открыт

Каждый ответ, включая ошибки, приходит с этими заголовками. API можно вызывать из браузера с любого сайта: он только читает данные и не использует cookie.

Заголовки ответа

Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, PATCH, DELETE, OPTIONS
Access-Control-Allow-Headers: Content-Type, Accept, Authorization, If-Match, If-None-Match, X-Request-Id, X-Assistant-Demo
Access-Control-Max-Age: 86400

На предварительный запрос OPTIONS любой адрес под /api/v1 отвечает кодом 204 с теми же заголовками.

Словари и статусы

Статус относится к сеансу, а не к событию целиком: отмена одного вечера не отменяет остальные. Плашка на сайте и в виджете сводит статус и наличие билетов в одно значение.

Как сеанс превращается в плашку

Правила проверяются сверху вниз. Отмена и перенос важнее наличия билетов, неподтверждённый статус не выдаётся за «состоится».

Сеанс	Плашка	Что значит
`status = cancelled`	Отменён	Сеанс отменён. Карточка остаётся в каталоге с этим статусом и не исчезает молча.
`status = postponed`	Перенесён, дата уточняется	Сеанс перенесён, новой даты пока нет.
`status = unknown` `status_is_verified = false`	Статус не подтверждён	Источник не подтвердил статус. Афиша не выдаёт такой сеанс за «состоится».
`availability = sold_out`	Билеты кончились	Сеанс состоится, но билетов по данным источника нет.
`status = rescheduled`	Перенесён	Сеанс перенесён, новая дата известна. Прежняя дата хранится рядом.
остальное	Состоится	Сеанс состоится: источник это подтверждает.

Три состояния цены

Цена события лежит в price_min, price_max и is_free. Она считается по общим и взрослым билетам: детские и льготные тарифы на неё не влияют, они есть в offers.

Демо-данные

Сейчас API отдаёт демонстрационные события с пометкой synthetic: true. Формат ответа тот же, что будет у боевого API.

Что такое демо-данные

Поле	Описание
`items`	События страницы. К полям события добавлены `matched_occurrence_ids` (сеансы, прошедшие условия) и `primary_occurrence_id` (ближайший из них: его дату и статус показывает карточка).
`total` `page` `page_size` `total_pages`	Пагинация.
`facets`	Счётчики для фильтров: те же, что отдаёт `GET /api/v1/facets`.
`applied`	Условия, которые сервер реально применил: вычисленные даты, статусы по умолчанию. В `active` перечислены условия, заданные пользователем.
`hidden_unknown_price`	Сколько событий подошло бы, но цена у них не указана.
`hidden_unknown_age`	Сколько событий подошло бы, но возрастная метка у них не указана.
`relaxations`	Варианты ослабить условия. Заполняется, только когда `total = 0`. В `query` лежат готовые условия для этого же метода, в `count` число событий, которое найдётся.
`reference_date` `timezone`	Дата и пояс, от которых считались периоды.

Поле	Описание
`action`	`search`: условий хватило, в ответе выдача. `clarify`: нужен ответ на вопрос. `out_of_scope`: запрос не про афишу или попытка обойти правила.
`message`	Короткая реплика ассистента.
`constraints`	Полное состояние условий `{ hard, soft }`. Передайте его в `previous` следующего запроса.
`chips`	Понятые условия для показа. Чтобы снять условие, отправьте `patch.unset = chip.unset`.
`assumptions`	Допущения, которые сделал ассистент: например, какая дата у «субботы».
`clarify`	Для `action = clarify`: вопрос, его код и готовые ответы `quick_replies`.
`results`	Для `action = search`: событие, подходящий сеанс, причины `reasons` из полей события и предупреждения `caveats`.
`total` `hidden_unknown_price` `hidden_unknown_age`	Сколько событий прошло условия и сколько не показано из-за неуказанной цены или возраста.
`relaxations`	Варианты ослабить условия, когда `total = 0`.
`unsupported_actions`	Что пользователь просил, а афиша не делает: например, `purchase`. Афиша не продаёт билеты.
`events_query`	Те же условия для каталога: из них строится ссылка «показать все».

`free`	Бесплатно	Все общие билеты бесплатные: источник сказал это явно.
`from`	от 500 ₽	Есть цена. Минимальная цена общего билета лежит в `price_min`, в рублях.
`unknown`	Цена не указана	Источник не сообщил цену. Это не значит, что вход свободный.

REST API афиши

Как подключить афишу на сайте министерства

Вставьте строку

Выберите параметры

Проверьте

Без вмешательства в действующие системы

Общие правила

Три правила достоверности

Методы

Список событий

Карточка события

Счётчики

Справочники

Подбор по фразе

Тело запроса

Служебные методы

Ошибки

CORS открыт

Словари и статусы

Как сеанс превращается в плашку

Три состояния цены

Демо-данные

Как понимаются периоды

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

Поля ответа

Пустая выдача и relaxations

Фраза и уточнение

Ответ на уточнение и выдача

Поля ответа

Коды городов и категорий

Города

Категории