YAML

Тип переменной: Структурированные данные в формате YAML

Переменная типа yaml позволяет хранить данные в формате YAML (YAML Ain't Markup Language). Этот формат более читаем для человека, чем JSON, и поддерживает комментарии, многострочные строки и ссылки.

💡 Совет: Если вы не знакомы с YAML, рекомендуется использовать тип json — он проще в освоении и полностью поддерживается платформой.

Как это работает

После сохранения YAML-объекта в переменную типа yaml (например, с именем config) через реакцию SetVarCloud, в контексте выполнения бота появится структура:

"var": {
  "person": {
    "config": {
      "theme": "dark",
      "notifications": true,
      "language": "ru"
    }
  }
}

Как получить доступ к значению

Путь к значению в реакциях:

${var.person.config.theme}

Важно: YAML автоматически конвертируется в JSON для работы внутри платформы. Вы обращаетесь к полям так же, как к JSON.

Пример YAML-данных

# Настройки пользователя
user:
  name: Алексей
  age: 30
  preferences:
    theme: dark
    fontSize: 14
    notifications:
      email: true
      telegram: false
  tags:
    - premium
    - early_adopter

Когда использовать YAML вместо JSON

Ограничения

• Максимальный размер YAML-переменной — 1 МБ
• Не все возможности YAML (якоря, ссылки) могут корректно обрабатываться
• При использовании в условиях (VarCloudValue) данные автоматически конвертируются в JSON