API шахматных турниров: бесплатная афиша для приложений, сайтов и ИИ-ассистентов

Коротко

Кому пригодится API шахматных мероприятий

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

Какие данные о турнирах отдаём

В ответе - турниры, которые ещё впереди или идут сегодня, по времени начала. Можно попросить один город параметром city или один турнир по номеру: GET /tournaments/{id}. Форматы - все, что проводят наши организаторы: швейцарская и круговая система, арена, шведские шахматы, командная швейцарка и свободная встреча.

Чего в ответе нет

Имён и контактов участников, закрытых турниров и турниров для узкого круга. Отдаём только то, что и так видно в публичной афише, - так данные можно показывать где угодно, не думая о чужой приватности.

Пример ответа

{
  "version": "1",
  "updated_at": "2026-11-05T05:00:00+03:00",
  "next_update_at": "2026-11-06T05:00:00+03:00",
  "items": [
    {
      "id": 3412,
      "title": "Вечерний рапид в «Шахматной гостиной»",
      "start_at": "2026-11-05T19:00:00+03:00",
      "timezone": "Europe/Moscow",
      "city": { "slug": "moscow", "name": "Москва" },
      "venue": { "name": "Шахматная гостиная", "address": "ул. Примерная, 1", "map_url": "https://yandex.ru/maps/?text=..." },
      "format": { "system": "swiss", "name": "Швейцарская система", "rounds": 7 },
      "time_control": { "code": "rapid_10_5", "label": "10+5", "name": "Рапид · 10 мин + 5 сек" },
      "players": { "registered": 18, "max": 32 },
      "entry_fee": { "amount": 500.0, "currency": "RUB" },
      "organizer": { "id": 77, "name": "Иван Петров", "rating": 4.9, "ratings_count": 41, "events_hosted": 23 },
      "photo_url": "https://vibechess.ru/uploads/tournaments/3412.jpg",
      "url": "https://vibechess.ru/app?t=3412"
    }
  ]
}

Как подключить API за три шага

1. 1

   Напишите нам

   В Telegram: кто вы, какой у вас продукт и в каком городе нужны турниры. Анкет и договоров нет.

2. 2

   Получите ключ

   Выдаём персональный ключ партнёра. Он ваш: по нему мы видим, кто спрашивает, и можем помочь, если что-то пойдёт не так.

3. 3

   Подключите один запрос

   GET /tournaments?city=moscow с заголовком X-Api-Key - раз в сутки, после 05:00 по Москве. Ключ держите на сервере, ответ храните до next_update_at.

Запрос из командной строки

curl -H 'X-Api-Key: vc_...' \
  'https://vibechess.ru/api/partner/v1/tournaments?city=moscow'

JavaScript на сервере

// На своём сервере: ключ в коде страницы увидит любой посетитель
const r = await fetch("https://vibechess.ru/api/partner/v1/tournaments?city=moscow", {
  headers: { "X-Api-Key": process.env.VIBECHESS_KEY },
});
const { items, next_update_at } = await r.json();
// Храните ответ до next_update_at: данные обновляются раз в сутки
for (const t of items) {
  console.log(t.start_at, t.title, t.venue.name, t.time_control.label, t.url);
}

Python

import os, requests

r = requests.get(
    "https://vibechess.ru/api/partner/v1/tournaments",
    params={"city": "omsk"},
    headers={"X-Api-Key": os.environ["VIBECHESS_KEY"]},
    timeout=10,
)
for t in r.json()["items"]:
    free = t["players"]["max"] and t["players"]["max"] - t["players"]["registered"]
    print(t["start_at"], t["title"], t["format"]["name"], "мест:", free)

Ограничение - 60 запросов в минуту на ключ, дальше ответ 429 с заголовком Retry-After. При раз-в-сутки сборке его хватает с огромным запасом. Ошибки приходят объектом {error: {code, message}}: unauthorized, too_many_requests, unknown_city, not_found.

Что можно сделать с афишей турниров

Открыты к сотрудничеству и доработаем под вас

Версия 1 - это афиша только для чтения. Это начало, а не потолок: систему мы пишем сами и меняем быстро. Если вашему продукту нужно больше, скажите что - и мы сделаем, в том числе:

• новые поля и фильтры под вашу задачу: по дате, формату, площадке, бесплатным турнирам;
• новые города - вслед за тем, где проходят турниры Vibe Chess;
• уведомления о новых и изменённых турнирах вместо ежедневного опроса;
• готовый блок-виджет для сайта;
• глубокие ссылки на запись в турнир из вашего приложения;
• совместные турниры и событие под вашу аудиторию - организацию мы берём на себя.

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

Для ИИ-ассистентов и агентов

Вопросы про API