Дизайн-афиша

События афиши в окне дат: город, онлайн или офлайн, направление, формат, поиск по тексту. Окно по умолчанию — 7 дней с сегодняшнего дня по Москве; задан только date_from — 7 дней от него; только date_to — с сегодня до date_to. Подставленные даты перечислены в applied_filters.defaulted_dates. Отбор — по пересечению интервала события с окном; сначала события, начинающиеся в окне (по началу), затем длящиеся — выставки и т. п. (по дате окончания). Серии — одной карточкой. По умолчанию отдаются только будущие и идущие события; прошедшие (past: true) — только если окно начинается раньше сегодняшнего дня по Москве (не глубже 60 дней). Ответ: краткие карточки (полное описание отдаёт get_event), total, next_cursor для следующей страницы, data_freshness. Если data_freshness = «резервная копия», живой список не прочитался и части событий может не быть — скажите об этом пользователю. Цен и статуса регистрации в данных нет.

{
  "type": "object",
  "properties": {
    "date_from": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Начало окна, YYYY-MM-DD, по Москве, включительно; по умолчанию сегодня. Не раньше 60 дней назад."
    },
    "date_to": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Конец окна, YYYY-MM-DD, по Москве, включительно; по умолчанию date_from + 6 дней. Окно не больше 92 дней."
    },
    "city": {
      "type": "string",
      "description": "Город, без регистра; «Питер», «СПб» → Санкт-Петербург."
    },
    "include_online": {
      "type": "boolean",
      "default": true,
      "description": "При заданном городе добавлять онлайн-события."
    },
    "mode": {
      "type": "string",
      "enum": [
        "offline",
        "online"
      ],
      "description": "Только офлайн или только онлайн."
    },
    "directions": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 10,
      "description": "Направления, любое из: ux, ai, brand, marketing, business, typography, books, vibecoding, gamedev, art-direction, illustration, collage, photography, visualization, video, architecture, product-design, fashion, craft, networking, career, creative, art. Названия — в list_directions."
    },
    "format": {
      "type": "string",
      "description": "Формат, точное значение: Выставка, Лекция, Воркшоп / мастер-класс, Конференция, Фестиваль, Экскурсия, Митап, Дискуссия, Кинопоказ, Интенсив, Презентация, Маркет, Хакатон, День открытых дверей, Конкурс, Челлендж."
    },
    "query": {
      "type": "string",
      "maxLength": 200,
      "description": "Подстрока в заголовке или описании, без регистра."
    },
    "include_ongoing": {
      "type": "boolean",
      "default": true,
      "description": "Включать события, начавшиеся до окна и ещё идущие."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 20
    },
    "cursor": {
      "type": "string",
      "description": "next_cursor из предыдущего ответа, с теми же фильтрами."
    }
  },
  "additionalProperties": false
}

Полная карточка события по id из адреса design-events.fun/event/<id> (или по самому адресу): описание (текст организатора, обрезан до 3000 знаков), время в поясе события, город, формат, направления, ссылка на карточку и на регистрацию, площадка и организатор именами, если подтверждены. У прошедшего события past: true — карточка остаётся архивной страницей.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "id события, как в url карточки."
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

Направления (темы) афиши: slug для search_events.directions, название и страница направления на сайте.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Pro, ранний доступ: личный недельный план по интересам и городу. Pro ещё не открыт — инструмент отвечает ссылкой на заявку. Не обещайте пользователю готовый план из этого инструмента; соберите его сами через search_events.

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string"
    },
    "interests": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  }
}