Документация по API шахматного рейтинга

API поддерживает три основных рабочих процесса расчета: изменение рейтинга одной игры (с учетом двух рейтингов, результата и К-фактора), пакетную обработку (несколько записей игр в одном запросе) и первоначальную оценку рейтинга (с учетом среднего рейтинга противника, счета и количества игр). Каждая конечная точка возвращает такие же подробные выходные данные, как на страницах калькулятора, включая ожидаемый балл, дельту рейтинга и прогнозируемый новый рейтинг. Подробности реализации и проверки смотрите в методологию.

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

Для доступа к API требуется ключ API, передаваемый в качестве токена носителя в заголовке авторизации. Ключи доступны в бесплатном и премиум-уровнях. Уровень бесплатного пользования допускает до 100 запросов в день, максимум 10 игр на пакетный запрос. Премиум-ключи открывают более высокую пропускную способность, приоритетную поддержку и доступ к конечным точкам массовой обработки турниров.

Ограничения скорости применяются для каждого ключа, а не для каждого IP-адреса. Превышение лимита возвращает статус 429 с заголовком Retry-After, указывающим, когда откроется следующее окно запроса. Все ограничения документируются в заголовках ответов каждого успешного запроса.

Каждый ответ API включает поле Rules_profile, указывающее, какой набор допущений использовался для расчета (например, fide_2024, us_chess_current, generic_elo). При изменении правил федерации API добавляет новую версию профиля, а не изменяет существующие. Это означает, что последующие системы могут привязываться к определенной версии профиля и обновляться по собственному графику.

О критических изменениях сообщается как минимум за 30 дней через журнал изменений API и список рассылки для разработчиков. Некритичные дополнения (новые необязательные поля, новые профили) развертываются постоянно, не нарушая существующие интеграции.

По возможности кэшируйте повторяющиеся вычисления локально, чтобы минимизировать вызовы API. Для рабочих процессов турниров используйте пакетную конечную точку, а не отправляйте последовательные запросы для одной игры. Всегда включайте параметр Rules_profile явно, а не полагайтесь на значение по умолчанию сервера, чтобы ваша интеграция оставалась детерминированной, даже когда API добавляет новые профили.

Для клубного программного обеспечения и панелей мониторинга тренеров рассмотрите возможность сохранения как вычисленных результатов, так и версии Rules_profile, чтобы вы могли провести аудит или пересчитать позже, если правила федерации изменятся. Это особенно важно для рабочих процессов официальной отчетности, где историческая точность имеет значение.