Créer une séance par lien

CIRKALI sait recevoir une séance entière décrite dans son adresse. Ouvrir un tel lien affiche un résumé et propose de l’importer : rien n’est enregistré sans que la personne ait choisi une destination. Aucun compte n’est nécessaire pour cela — la séance voyage dans l’URL et ne passe par aucun serveur.

Cette page est écrite pour une intelligence artificielle à qui on donne l’adresse du site et qui doit produire un lien valide du premier coup.

La forme du lien

https://cirkali.fr/?s=<base64url du JSON>

L’enveloppe JSON

En mode classique, les séries d’un exercice s’enchaînent avant de passer au suivant, avec le repos réglé sur chaque ligne. En mode circuit, les séries alternent les groupes musculaires et le repos de chaque ligne est ignoré : c’est p qui s’applique.

Les lignes

Chaque ligne est un tableau positionnel, pas un objet.

Exercice : ["e", clé, groupe, effort, séries, répétitions, secondes, repos, nomPerso?]
Pause    : ["r", secondes]

Renseigner les deux valeurs (répétitions et secondes) est normal : seule celle qui correspond à l’effort choisi est affichée, l’autre sert si l’on bascule l’unité. Une clé absente de la liste est traitée comme "custom".

Exercice personnalisé

Un mouvement absent de la bibliothèque s’écrit avec la clé "custom", le groupe musculaire qui lui correspond, et son nom en neuvième position. Le groupe compte : c’est lui qui fait alterner les efforts en mode circuit.

["e", "custom", "cardio", "r", 3, 10, 30, 60, "Burpees"]

Encodage

Le JSON est encodé en base64url : base64 standard, puis + remplacé par -, / par _, et le remplissage = retiré. Aucune compression.

Exemple complet

Le JSON ci-dessous et la chaîne qui le suit sont générés ensemble à chaque build : ce lien fonctionne.

{"v":1,"n":"Haut du corps","m":"x","p":60,"t":0,"i":[["e","kneePushup","push","r",4,12,30,60],["e","superman","back","r",3,10,30,60],["e","plank","core","t",3,10,45,60],["r",90],["e","custom","cardio","r",3,10,30,60,"Burpees"]]}

https://cirkali.fr/?s=eyJ2IjoxLCJuIjoiSGF1dCBkdSBjb3JwcyIsIm0iOiJ4IiwicCI6NjAsInQiOjAsImkiOltbImUiLCJrbmVlUHVzaHVwIiwicHVzaCIsInIiLDQsMTIsMzAsNjBdLFsiZSIsInN1cGVybWFuIiwiYmFjayIsInIiLDMsMTAsMzAsNjBdLFsiZSIsInBsYW5rIiwiY29yZSIsInQiLDMsMTAsNDUsNjBdLFsiciIsOTBdLFsiZSIsImN1c3RvbSIsImNhcmRpbyIsInIiLDMsMTAsMzAsNjAsIkJ1cnBlZXMiXV19

Le lien à donner

Donnez toujours ce lien tel quel — jamais enveloppé dans une recherche (google.com/search) ni raccourci. Certains assistants ajoutent cette enveloppe automatiquement : si le lien que vous vous apprêtez à donner en contient une, retirez-la avant de répondre. L’import en un clic ne fonctionne qu’avec le lien exact.

Les 62 clés d’exercice

Les 9 groupes musculaires

Si le base64 pose problème

Un second paramètre, ?plan=, accepte la même séance en JSON lisible non encodé, avec des noms de champs explicites. Il est plus long et ne rentre pas dans un QR code, mais il se relit à l’œil et se corrige. À utiliser en repli lorsque la chaîne base64 risque d’être approximative.

https://cirkali.fr/?plan={"name":"Haut du corps","mode":"circuit","pause":60,"items":[
  {"ex":"kneePushup","sets":4,"reps":12,"rest":60},
  {"ex":"plank","sets":3,"seconds":45},
  {"ex":"Burpees","group":"cardio","sets":3,"reps":10},
  {"rest":90}
]}

Dans cette forme : ex accepte une clé de la bibliothèque ou un nom libre (qui devient un exercice personnalisé) ; le groupe, le type d’effort et tout champ absent sont déduits de la bibliothèque ; reps seul impose l’effort en répétitions, seconds seul l’impose en durée ; une ligne sans ex est une pause dont rest donne la durée. Les noms de champs sont insensibles à la casse et les nombres acceptés sous forme de chaîne. Maximum 60 lignes.

Une réserve d’encodage propre à cette forme : le JSON voyage en clair dans la partie requête de l’URL, donc & et # doivent être encodés en %26 et %23 — sinon le premier coupe le paramètre en deux et le second tronque tout ce qui suit. Le plus sûr reste d’encoder l’ensemble de la valeur avec un encodeURIComponent. Le paramètre ?s= n’a pas ce problème : le base64url n’utilise que des caractères sans signification dans une URL.

Consignes de rédaction d’une séance

• Alterner les groupes musculaires plutôt que d’enchaîner deux fois le même.
• Rester dans les ordres de grandeur des réglages par défaut ci-dessus : ils sont propres à chaque exercice.
• Préférer les clés de la bibliothèque aux exercices personnalisés : elles apportent une figure, un conseil d’exécution et une fiche détaillée.
• Ne jamais poser de diagnostic ni prescrire à une personne blessée : proposer une séance, pas un traitement.