Formatti una voce Keep a Changelog per tipo di modifica
Indichi la versione 2.4.0, la data 2026-07-25 e i suoi elenchi di modifiche: ottiene la voce intitolata ## [2.4.0] - 2026-07-25, con Added, Changed, Fixed e Removed nell’ordine consueto. I gruppi vuoti vengono omessi. Gratis nel suo browser.
- Gratis
- Funziona nel suo browser
- Senza registrazione
- I suoi dati restano sul dispositivo
Esegui gratis nel browser
Trasformi i dati strutturati di una versione in una voce Keep a Changelog uniforme senza ordinare manualmente titoli ed elenchi. Indichi versione, data e liste di elementi aggiunti, modificati, corretti o rimossi. Il formattatore conserva l’ordine, omette le sezioni vuote e restituisce Markdown pronto da inserire. Il risultato deterministico è adatto a script di rilascio, distribuzione continua, strumenti di repository e verifiche editoriali.
Prepari le informazioni prima della formattazione
Parta da versione e data, quindi classifichi ogni novità come aggiunta, modifica, correzione o rimozione. Scriva descrizioni concise e comprensibili senza riferimenti interni. Il formattatore non inventa né riassume le note: conserva le parole e l’ordine forniti.
I gruppi vuoti possono essere omessi. Versione e data devono contenere testo; per la data è consigliato YYYY-MM-DD, facilmente leggibile e ordinabile ovunque.
Comprenda la struttura Markdown generata
Il risultato inizia con un titolo di secondo livello contenente la versione tra parentesi quadre e la data. Seguono solo i gruppi non vuoti, sempre nell’ordine Aggiunto, Modificato, Corretto e Rimosso. Ogni gruppo ha un titolo di terzo livello e punti elenco.
Gli spazi esterni e un eventuale punto iniziale vengono rimossi per evitare duplicati.
Inserisca il formattatore nel rilascio
Lo utilizzi dopo l’approvazione delle note e prima dell’inserimento nel file del repository. Uno script può raccogliere descrizioni strutturate, richiedere la formattazione e inviare il risultato alla revisione o a un passaggio separato di aggiornamento. La capacità non legge commit, non consulta ticket, non modifica file e non sceglie versioni semantiche.
Controlli la voce nel changelog completo se il progetto usa titoli o collegamenti personalizzati.
Casi d'uso
Uniformare l’automazione
Converta dati strutturati in Markdown prevedibile prima dell’aggiornamento.
Preparare le note per la revisione
Fornisca una voce ordinata per concentrarsi su precisione e chiarezza.
Unificare più repository
Applichi gli stessi titoli e punti ai servizi con struttura condivisa.
Domande frequenti
Quali tipi sono supportati?
Sono supportati aggiunte, modifiche, correzioni e rimozioni, in quest’ordine.
Che cosa accade a un gruppo vuoto?
Il titolo viene omesso e compaiono solo sezioni con modifiche.
Genera note dai commit?
No. Formatta le descrizioni fornite senza esaminare commit, ticket o repository.
Modifica il file changelog?
No. Restituisce una voce Markdown; inserirla nel file è un passaggio separato.
In che ordine compaiono le sezioni della voce?
Sempre nell’ordine Added, Changed, Fixed e Removed, anche se i gruppi arrivano in un ordine diverso. All’interno di ogni gruppo, invece, le descrizioni restano nella sequenza in cui le ha scritte, così può mettere prima le più importanti.
Strumenti correlati
Per sviluppatori — accesso via API
Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo stack
curl -X POST https://api.kit.forhosting.com/dev2/changelog-entry-format \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"version":"2.4.0","date":"2026-07-25"}'const res = await fetch("https://api.kit.forhosting.com/dev2/changelog-entry-format", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"version": "2.4.0",
"date": "2026-07-25"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/dev2/changelog-entry-format",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"version": "2.4.0",
"date": "2026-07-25"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/dev2/changelog-entry-format", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"version":"2.4.0","date":"2026-07-25"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"version":"2.4.0","date":"2026-07-25"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/dev2/changelog-entry-format", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Esempio di richiesta
{
"version": "2.4.0",
"date": "2026-07-25"
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "dev2.changelog_entry_format",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |
Note tecniche
Comprenda la struttura Markdown generata
Il campo changelog termina con una nuova riga e lo stesso input valido produce sempre lo stesso testo nel browser e tramite API.
Inserisca il formattatore nel rilascio
Ogni richiesta API costa $0.002.
Domande tecniche
Quanto costa?
Ogni richiesta API costa $0.002.
La versione deve essere semantica?
No. Deve contenere testo, ma viene mantenuto lo schema da Lei usato.