LichessStatTgWeb/LichessWebServices
vrubelroman 31e6fdd23d
All checks were successful
CI/CD Pipeline / build-and-deploy (push) Successful in 15s
serialize shared-token lichess.org requests to fix accuracy dropping again
games/user and user/activity share one LICHESS_APP_TOKEN process-wide, and
Lichess allows only 1 concurrent request per token there (confirmed live:
429 "Please only run 1 request(s) at a time" under concurrent traffic).
The existing rate limiter only paced request starts 0.2s apart without
holding the lock through the request itself, so concurrent games/period
calls (periodic checks vs. on-demand /today etc.) could still collide and
get 429'd, silently dropping the accuracy shown in /today, /yesterday,
/week (that fetch is best-effort and swallows errors). Hold a dedicated
lock for the full request/response cycle on these two calls; puzzle
requests use per-user tokens and don't need it.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-07-25 23:26:25 +00:00
..
API_DOCUMENTATION.md Создание единого проекта Lichess Statistics Ecosystem 2025-10-26 20:23:26 +03:00
Dockerfile Создание единого проекта Lichess Statistics Ecosystem 2025-10-26 20:23:26 +03:00
lichess_client.py serialize shared-token lichess.org requests to fix accuracy dropping again 2026-07-25 23:26:25 +00:00
main.py stop infinite retry loop on rejected Lichess tokens 2026-07-05 07:37:14 +00:00
models.py stop infinite retry loop on rejected Lichess tokens 2026-07-05 07:37:14 +00:00
rate_limiter.py serialize shared-token lichess.org requests to fix accuracy dropping again 2026-07-25 23:26:25 +00:00
README.md Создание единого проекта Lichess Statistics Ecosystem 2025-10-26 20:23:26 +03:00
requirements.txt Создание единого проекта Lichess Statistics Ecosystem 2025-10-26 20:23:26 +03:00
stats_service.py stop infinite retry loop on rejected Lichess tokens 2026-07-05 07:37:14 +00:00

Lichess Statistics API

REST API сервис для получения статистики игроков Lichess.org по играм и решению задач.

Возможности

  • Получение статистики за сегодняшний день
  • Получение статистики за вчерашний день
  • Получение статистики за последние 7 дней
  • Поддержка режимов игры: Bullet, Blitz, Rapid
  • Статистика по решению задач (пазлов)
  • Расчет изменения рейтинга
  • Подсчет побед, поражений и ничьих

Запуск с Docker

1. Сборка и запуск контейнера

# Сборка образа
docker-compose build

# Запуск сервиса
docker-compose up -d

2. Проверка работы

Сервис будет доступен по адресу: http://localhost:8000

API Endpoints

Получить статистику за сегодня

GET /stats/{username}/today

Получить статистику за вчера

GET /stats/{username}/yesterday

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

GET /stats/{username}/week

Примеры использования

Статистика за сегодня

curl http://localhost:8000/stats/vrubelroman/today

Статистика за вчера

curl http://localhost:8000/stats/vrubelroman/yesterday

Статистика за неделю

curl http://localhost:8000/stats/vrubelroman/week

Формат ответа

{
  "message": "Статистика за сегодняшний день",
  "data": {
    "username": "vrubelroman",
    "tasks": {
      "total": 28,
      "solved": 25,
      "unsolved": 3
    },
    "games": {
      "bullet": {
        "games_played": 7,
        "rating_change": 30,
        "final_rating": 2320,
        "wins": 5,
        "losses": 0,
        "draws": 0
      },
      "blitz": {
        "games_played": 5,
        "rating_change": 32,
        "final_rating": 2224,
        "wins": 5,
        "losses": 0,
        "draws": 0
      },
      "rapid": {
        "games_played": 2,
        "rating_change": -10,
        "final_rating": 2210,
        "wins": 1,
        "losses": 1,
        "draws": 0
      }
    }
  }
}

Остановка сервиса

docker-compose down

Логи

Для просмотра логов:

docker-compose logs -f