L’API publique ChessPivot

ChessPivot expose une API publique documentée : quatre routes en lecture seule qui rendent vos propres données — parties, répertoire, faiblesses, profil — à vos outils, protégées par un jeton d’accès personnel.

Obtenir un jeton

Le jeton se génère depuis la page Mon compte, section « Jetons d’accès à l’API ». Il n’est affiché qu’une seule fois — nous n’en conservons qu’une empreinte — et se révoque au même endroit. Chaque requête l’envoie dans l’en-tête suivant :

Authorization: Bearer cp_0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef

Ouvrir Mon compte

Les routes

Vos parties (PGN)

GET /api/public/v1/games

Rend vos parties au format PGN, un bloc par partie. Paramètres optionnels : since et until (bornes de dates incluses, format AAAA-MM-JJ, UTC), limit (de 1 à 500 parties par page, 100 par défaut) et cursor. Quand une page est pleine, l’en-tête de réponse X-Next-Cursor donne le curseur de la page suivante ; son absence signale la dernière page.

Exemple

curl -H "Authorization: Bearer cp_0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef" \
  "https://www.chesspivot.com/api/public/v1/games?since=2026-01-01&limit=100"

Votre répertoire (PGN)

GET /api/public/v1/repertoire

Rend votre répertoire d’ouvertures au format PGN. Paramètre optionnel : locale (fr ou en, fr par défaut), la langue des noms d’ouvertures dans les en-têtes du fichier.

Exemple

curl -H "Authorization: Bearer cp_0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef" \
  "https://www.chesspivot.com/api/public/v1/repertoire?locale=fr"

Vos faiblesses (JSON)

GET /api/public/v1/weaknesses

Rend, pour chaque compte rattaché, vos faiblesses détectées : identifiant stable, nom en français et en anglais, nombre de parties concernées et tendance récente. Rien de plus — la mécanique de détection n’est pas publiée.

Exemple

curl -H "Authorization: Bearer cp_0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef" \
  "https://www.chesspivot.com/api/public/v1/weaknesses"

Votre profil (JSON)

GET /api/public/v1/profile

Rend les pseudos rattachés au compte, le nombre de parties analysées et la date de la dernière analyse, compte par compte.

Exemple

curl -H "Authorization: Bearer cp_0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef" \
  "https://www.chesspivot.com/api/public/v1/profile"

Limites de débit

30 requêtes par minute et par adresse IP, toutes routes confondues. Au-delà, la réponse est un code 429 : attendez la minute suivante. Un jeton absent, invalide ou révoqué reçoit un code 401.

La politique de l’API

Lecture seule : aucune route n’écrit, ne modifie ni ne supprime quoi que ce soit.
Vos données uniquement : le périmètre servi sort du jeton — aucune route n’accepte d’identifiant de compte, il n’existe donc aucun paramètre à falsifier pour lire les données d’autrui.
Révocation immédiate : un jeton révoqué depuis Mon compte est refusé dès la requête suivante.
Le savoir-faire reste fermé : l’API expose ce que le service a trouvé, jamais comment il l’a trouvé — aucun seuil ni paramètre de détection n’est publié.