Быстрый старт: счётчик за 5 минут

Следуйте шагам сверху вниз. После прохождения страницы у вас будет рабочий счётчик смертей с горячими клавишами в OBS.

Что понадобится

• Авторизованный аккаунт VseStream.
• OBS 28+ (Windows или macOS).
• Плагин «Advanced Scene Switcher» или встроенные горячие клавиши OBS.
• Опционально: Stream Deck / Touch Portal — команды будут такие же.

Шаг 1. Получаем токен

1. Откройте страницу OBS → Integrations.
2. Нажмите «Создать токен», если его ещё нет. Скопируйте значение — оно нужно для любых запросов.
3. Эта страница уже показывает токен в верхнем блоке «Ваши интеграции API» — всё можно скопировать кнопкой.

Шаг 2. Создаём счётчик

1. На той же странице нажмите «Мои счётчики» → «Добавить».
2. Введите название (например, Dark Souls) и короткий slug, который пойдёт в ссылку (dark_souls).
3. После сохранения карточка счётчика появится в блоке «Счётчики смертей» здесь в документации — все ссылки и curl-команды уже готовы.

Шаг 3. Проверяем, что API отвечает

1. Перейдите на /api/v2/docs/.
2. В поле Authorization автоматически подставится ваш токен. Нажмите на метод GET /api/v2/counter/{token}/{slug}/ и кнопку «Try it out».
3. Если ответ 200 и в JSON видно значение счётчика — всё готово. Если нет, ниже на странице есть раздел «Что делать, если…».

Шаг 4. Подключаем к OBS

Вариант A — панель внутри OBS

1. В OBS добавьте источник Browser.
2. Используйте ссылку вида https://vsestream.live/api/v2/control/<ТОКЕН>/<SLUG>/ (уникальная ссылка есть в карточке счётчика выше).
3. Задайте размер 500×640 и включите «Refresh browser when scene becomes active».
4. Кнопки I / O / R внутри панели сразу работают: можно тестировать без хоткеев.

Вариант B — горячие клавиши

1. Установите Advanced Scene Switcher (если ещё не установили).
2. Откройте Tools → Advanced Scene Switcher → Macro.
3. Создайте три макроса с хоткеями F13/F14/F15 и командами из карточки счётчика («+1», «-1», «Reset»). Нажмите «Test» — счётчик в панели должен меняться.
4. Для Stream Deck используйте тот же текст команды в действии «Run Command». OBS даже не нужен открыт.

Шаг 5. Что можно добавить

• Несколько счётчиков? Создайте новые slug — карточки появятся автоматически.
• Таймер? Раздел «Интеграции: таймеры» описывает настройку и готовые команды.
• Готовый набор для Advanced Scene Switcher? Нажмите кнопку «Скачать JSON» под карточками — импортируйте файл в плагин.

Команды для копирования

Структура одинаковая, меняются только адрес и действие. Замените TOKEN и SLUG на значения из вашего блока выше.

curl -X POST "https://vsestream.live/api/v2/counter/TOKEN/SLUG/" \
  -H "Content-Type: application/json" \
  -d '{"action":"increment","value":1}'  # +1

curl -X POST "https://vsestream.live/api/v2/counter/TOKEN/SLUG/" \
  -H "Content-Type: application/json" \
  -d '{"action":"decrement","value":1}'  # -1

curl -X POST "https://vsestream.live/api/v2/counter/TOKEN/SLUG/" \
  -H "Content-Type: application/json" \
  -d '{"action":"reset"}'  # сброс

curl "https://vsestream.live/api/v2/counter/TOKEN/SLUG/"  # просто узнать текущее значение

Если что-то пошло не так

API отвечает 403 (запрещено)

Проверьте, что скопирован именно активный токен. Если токен меняли, старые ссылки нужно обновить.

404 (не найдено)

Slug в ссылке не совпадает. Загляните в карточку счётчика — там указан точный вариант.

Команда в OBS ничего не делает

Убедитесь, что OBS видит curl. В Windows 10+ он установлен по умолчанию. Если при тесте появляется окно безопасности, разрешите запуск.

Хоткеи конфликтуют

Используйте F13–F24 или комбинации с Ctrl/Shift, которые не задействованы в играх.

Готово! Теперь можно переходить к следующему разделу или добавить второй счётчик. Остальные интеграции настраиваются по той же схеме.