Notes de version
Cette capacité transforme une liste de commits ou de notes techniques en un changelog lisible : nouveautés, améliorations, corrections et changements notables, regroupés par catégorie et reformulés pour un lecteur qui n’a pas écrit le code. Le but : des notes de version qu’un utilisateur comprend, pas un journal brut.
Exécuter en ligne
Exécutez cette tâche sur nos serveurs, avec votre compte. Les outils gratuits tournent dans votre navigateur ; celui-ci est facturé sur votre solde KIT au prix affiché ci-dessus.
Du commit brut à la note lisible
Un message de commit parle au développeur, rarement à l’utilisateur. Vous collez la liste des changements — messages de commit, tickets résolus, notes de développement — et l’outil les traduit en phrases claires, orientées bénéfice : ce qui change pour la personne qui utilise le produit, pas la mécanique interne. Le jargon disparaît, l’information utile reste, et une version illisible devient une note que l’on comprend au premier passage.
Un classement par catégorie
Les bonnes notes de version distinguent ce qui est ajouté, corrigé, amélioré ou modifié de façon incompatible. L’outil range chaque entrée sous la bonne rubrique et signale les changements notables — ceux qui demandent une action de l’utilisateur. Vous pouvez suivre une convention courante, adaptée aux habitudes de la communauté technique, pour que vos versions se lisent toujours de la même manière.
Format, canal et prix
Le changelog s’obtient en texte structuré, prêt à publier sur une page de version ou dans un dépôt. Vous collez vos commits sur cette page ; pour l’intégrer à une chaîne de publication, la capacité s’appelle aussi en API, avec l’e-mail et l’application à venir. Le tarif : $0.003 la requête, plus $0.0135 par version rédigée, en dollars US, affiché avant l’envoi.
Cas d’usage
Publier les notes d’une mise à jour
Studio Lumen SAS colle les commits d’une nouvelle version de son application et obtient un changelog clair — nouveautés, corrections — que ses clients lisent sans décoder de jargon.
Tenir un journal de version régulier
Julien Lefèvre alimente la page « Nouveautés » de son outil à chaque livraison, en repartant des tickets résolus plutôt que de rédiger à la main.
Communiquer un changement incompatible
Thomas Rousseau met en avant, dans les notes, un changement qui demande une action des utilisateurs, clairement séparé des simples corrections.
Questions fréquentes
Dois-je fournir mes messages de commit ?
Oui : commits, tickets ou notes de développement servent de matière. Plus ils sont précis, plus les notes de version sont fidèles et complètes.
Le résultat est-il compréhensible par un non-développeur ?
C’est l’objectif : l’outil reformule les changements techniques en bénéfices lisibles, en retirant le jargon interne.
Les changements incompatibles sont-ils signalés ?
Oui. Ceux qui demandent une action de l’utilisateur sont distingués des simples ajouts ou corrections, sous une rubrique à part.
Puis-je suivre une convention de changelog ?
Oui. Vous pouvez demander un classement par catégories standard afin que vos versions gardent une présentation homogène.
Combien coûte la rédaction d’une version ?
$0.003 la requête, plus $0.0135 par version, en dollars US. Le montant est connu avant l’envoi, sans abonnement.
Mon code ou mes commits sont-ils conservés ?
Non. Ils transitent chiffrés, servent à produire le changelog, puis ne sont rattachés à aucun compte ni dépôt.
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
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/text/changelog \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"input":"…"}'const res = await fetch("https://api.kit.forhosting.com/text/changelog", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"input": "…"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/text/changelog",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"input": "…"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/text/changelog", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"input":"…"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"input":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/text/changelog", 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
{
"input": "…"
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "text.changelog",
"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
Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.
Limites
max_tokens | 20000 |
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. |
422 | task_failed | La tâche a échoué : elle ne vous est pas facturée. |