đŸ‘Ÿ Darkwood : CrĂ©er un jeu tactique axĂ© sur les API

le 7 mars 2026

Darkwood est désormais jouable entiÚrement via API.

Il n'y a pas d'interface utilisateur dédiée. Aucune interface utilisateur requise. Pas de client graphique.

Vous interagissez avec le jeu via HTTP.

Que signifie réellement « API-First » ?

Dans Darkwood, la boucle de jeu est simple et explicite :

  1. GET /api/darkwood/state → observer la situation actuelle
  2. Interpréter la réponse JSON
  3. POST /api/darkwood/action → dĂ©cider de l'action Ă  effectuer
  4. Recevoir l'Ă©tat mis Ă  jour
  5. Répéter

Le jeu se comporte comme une machine Ă  Ă©tats via HTTP.

Chaque réponse comprend :

  • Ă©tat — oĂč vous vous trouvez (principal, combat, infos, boutique, etc.)
  • mode — sous-phase (combat, victoire, mort, etc.)
  • data — dĂ©tails contextuels (vie, ennemi, statistiques, session de combat)

Votre client — qu'il s'agisse de curl, d'un outil en ligne de commande, d'un script ou d'un agent d'IA — lit l'Ă©tat et dĂ©cide de la prochaine action.

Il n'y a pas de logique d'interface utilisateur cachée.

Le protocole est la clé du jeu.

Deux niveaux d'accĂšs

Darkwood divise l'accÚs en deux niveaux :

1ïžâƒŁ AccĂšs API

Chaque demande doit inclure :

X-API-Key: <your-key>

La clé API contrÎle :

  • Si vous pouvez appeler l'API
  • Que vous fassiez partie de la saison bĂȘta 0
  • Que vous ayez un accĂšs premium
  • Votre quota d'actions quotidien (pour les clĂ©s gratuites)

2ïžâƒŁ IdentitĂ© du joueur

Pour jouer avec un personnage spécifique (progression persistante, combats, statistiques), vous vous authentifiez avec :

Authorization: Bearer <jwt-token>

Le JWT identifie le compte du joueur. La clé API contrÎle l'accÚs et la monétisation.

Ils sont séparés par conception.

La documentation complÚte est disponible sur GitHub : https://github.com/darkwood-com/darkwood-com/blob/main/docs/

Gratuit vs Premium

Darkwood est actuellement en cours de dĂ©veloppement en BĂȘta Saison 0.

Il existe deux types de clés :

🎟 AccĂšs bĂȘta (gratuit)

  • ClĂ© API personnelle
  • Actions quotidiennes limitĂ©es
  • AccĂšs Ă  l'Ă©tat jouable actuel
  • AccĂšs aux archives impossible

💎 Fondateur Premium

  • ClĂ© API personnelle
  • Actions quotidiennes illimitĂ©es
  • AccĂšs aux instantanĂ©s archivĂ©s des puzzles
  • Statut de soutien prĂ©coce

Les archives sont des instantanés en lecture seule des états jouables antérieurs. Ils permettent de révéler l'état historique du jeu sans modifier le déroulement en direct.

Édition limitĂ©e pour les fondateurs

Pour que ce lancement reste sous contrÎle :

  • 5 clĂ©s d'accĂšs bĂȘta
  • 5 clĂ©s Fondateur Premium

C'est ça.

Il ne s'agit pas d'un lancement à grande échelle. Il s'agit d'une version ciblée visant à valider le modÚle.

Les ventes sont gérées par Bonzai :

Chaque clĂ© est personnelle. Les touches peuvent ĂȘtre pivotĂ©es si nĂ©cessaire.

Pourquoi pas d'interface utilisateur ?

Parce que l'interface est optionnelle.

Vous pouvez jouer Ă  Darkwood avec :

  • boucle
  • Facteur
  • une interface de ligne de commande personnalisĂ©e
  • un petit client web
  • un script
  • un agent d'IA

L'API définit le contrat du jeu.

Le client n'est qu'un interprĂšte.

Saison bĂȘta 0

La logique du jeu reste inchangée.

L'objectif de cette phase est :

  • StabilitĂ© de l'API
  • ModĂšle de monĂ©tisation propre (clĂ© API uniquement)
  • Flux d'Ă©tat dĂ©terministe
  • ClartĂ© de la documentation

Pas de sur-ingénierie. Aucune fonctionnalité superflue.

Un simple jeu tactique déguisé en protocole.

Darkwood n'est pas qu'un simple projet backend.

C'est un jeu qui fonctionne entiĂšrement via HTTP.

Et la saison 0 de la bĂȘta est maintenant disponible.