ForHosting KIT · Maison, cuisine et loisirs

Valider la notation algébrique des échecs

Nbd2+ est correctement écrit : un cavalier de la colonne b va en d2 et fait échec. Saisissez un coup pour confirmer qu’il suit la notation algébrique standard et voir la pièce, la case d’arrivée, la prise, l’échec ou la promotion. Gratuit dans votre navigateur.

Gratuit
Fonctionne dans votre navigateur
Sans inscription
Vos données restent sur votre appareil

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Exemple résolu

Si vous saisissez

Notation: Nbd2+

Vous obtenez

Type de coup: piece
Pièce: N
Destination: d2
Colonne d'origine: b

Ce validateur vérifie si un coup respecte la syntaxe de la notation algébrique standard, appelée SAN. Il reconnaît les coups de pion et de pièce, les prises, la désambiguïsation de l'origine, la promotion, le roque, l'échec et le mat. Le contrôle reste volontairement syntaxique : il ne requiert aucune position et ne prétend pas que le coup soit légal dans une partie donnée. Utilisez-le pour repérer une chaîne mal formée avant de stocker, importer, afficher ou traiter des données échiquéennes.

Les formes reconnues par le validateur

La notation algébrique standard condense un coup d'échecs dans une chaîne courte et structurée. Un coup de pièce commence par K, Q, R, B ou N en majuscule, puis peut comporter une indication d'origine, un symbole de prise et une case d'arrivée telle que e4 ou h8. Les coups de pion omettent la lettre de pièce : e4 indique une avance simple, tandis que exd5 désigne un pion de la colonne e qui prend en d5.

Une promotion ajoute le signe égal puis Q, R, B ou N, par exemple e8=Q ou fxg8=N. Le validateur accepte également O-O et O-O-O pour les deux roques. Un signe plus final marque l'échec et un dièse final, le mat.

La casse compte, car les lettres de pièces sont majuscules et les colonnes minuscules. Le résultat précise la catégorie, la destination, la prise, l'échec ou le mat, ainsi que toute origine ou promotion présente.

Valider la syntaxe ne prouve pas la légalité

Cet outil répond à une question précise : la chaîne a-t-elle la forme d'un coup SAN ? Il ne reçoit ni échiquier, ni historique, ni trait, ni droits de roque, ni état de prise en passant. Il ne peut donc pas déterminer si une pièce atteint réellement la case indiquée.

Nf3 reste syntaxiquement correct même si, dans une position donnée, aucun cavalier ne peut atteindre f3. De même, un symbole d'échec correctement placé est accepté sans prouver que le roi adverse est attaqué. Cette séparation est utile lors des imports : une faute de notation et un coup interdit exigent des explications différentes.

Une case incomplète, une lettre de pièce minuscule, un symbole de prise déplacé, une colonne impossible ou un suffixe inconnu sont rejetés sans reconstruire la partie. Après validation, vous pouvez confier le contrôle de légalité à un moteur disposant de la position. Le champ valid confirme uniquement la structure de la notation.

Cas d’usage

Nettoyer une colonne de coups importée

Refusez les chaînes SAN incorrectes avant leur insertion dans une base ou un analyseur de parties.

Contrôler un champ de formulaire

Fournissez un retour immédiat et cohérent lorsqu'un joueur ou un éditeur saisit un coup.

Vérifier du contenu échiquéen généré

Contrôlez les coups produits par des cours, problèmes, rapports ou autres outils déterministes.

Questions fréquentes

Un résultat valide signifie-t-il que le coup est légal ?

Non. Il confirme uniquement la syntaxe SAN. La légalité nécessite une position, un historique et un moteur de règles.

Quelles lettres de pièces sont acceptées ?

K, Q, R, B et N sont acceptées en majuscules. En SAN, un pion n'a pas de lettre initiale.

Les prises, échecs et mats sont-ils reconnus ?

Oui. Utilisez x pour une prise, + pour un échec et # pour un mat aux emplacements SAN prévus.

Le roque et la promotion sont-ils reconnus ?

Oui. Les formes O-O, O-O-O et les promotions =Q, =R, =B ou =N sont acceptées.

Les espaces autour du coup sont-ils supprimés ?

Non. Ils rendent l'entrée incorrecte afin que les problèmes de nettoyage restent visibles.

Outils associés

Pour les développeurs — accès API

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

Endpoint

POSThttps://api.kit.forhosting.com/game/chess-algebraic-validate

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

Appeler depuis votre stack

curl -X POST https://api.kit.forhosting.com/game/chess-algebraic-validate \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"notation":"Nbd2+"}'

const res = await fetch("https://api.kit.forhosting.com/game/chess-algebraic-validate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "notation": "Nbd2+"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/game/chess-algebraic-validate",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "notation": "Nbd2+"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/game/chess-algebraic-validate", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"notation":"Nbd2+"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"notation":"Nbd2+"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/game/chess-algebraic-validate", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemple de requête

{
  "notation": "Nbd2+"
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "game.chess_algebraic_validate",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

Tarifs

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

Erreurs

HTTP	Code	Signification
`401`	`unauthorized`	Clé API absente ou invalide : vérifiez l’en-tête Authorization.
`402`	`insufficient_balance`	Solde insuffisant : rechargez votre compte pour lancer cette tâche.
`404`	`unknown_type`	Type de tâche inconnu : vérifiez le champ type de votre requête.
`429`	`rate_limited`	Trop de requêtes : ralentissez la cadence, puis réessayez.

Notes techniques

Exploiter le résultat dans une application

Envoyez exactement une chaîne dans le champ notation. Les espaces placés avant ou après sont refusés au lieu d'être supprimés silencieusement, afin de révéler les données sales dans une colonne ou un import ligne par ligne. Une réponse réussie conserve la valeur initiale et fournit des champs stables, évitant à votre logiciel d'analyser SAN une seconde fois. move_type distingue pion, pièce et roque. Les pièces renvoient leur lettre SAN et leur destination ; P représente les pions. capture est toujours booléen, tandis que origin_file, origin_rank, promotion et le côté du roque n'apparaissent que lorsqu'ils s'appliquent. check et mate sont deux booléens distincts. Une valeur incorrecte déclenche invalid_input plutôt que valid à false, ce qui permet d'arrêter un import ou de signaler le champ. L'exécution est déterministe, sans réseau, et identique dans le navigateur et l'API. L'usage interactif est gratuit ; l'automatisation coûte $0.002 par requête.

Questions techniques

Quel est le coût d'une validation par API ?

Chaque requête API coûte $0.002. La version disponible dans le navigateur est gratuite.

Consulter la documentation complète du KIT →

Lancer gratuitement