RSS e JSON Feed
GET https://api.changeloop.dev/v1/public/YOUR_PUBLIC_ID/rss.xmlGET https://api.changeloop.dev/v1/public/YOUR_PUBLIC_ID/feed.jsonLe stesse voci pubblicate come feed sottoscrivibile, nei due formati che i lettori capiscono: RSS 2.0 e JSON Feed 1.1. Entrambi accettano gli stessi filtri repos, category e tag del feed del changelog e hanno lo stesso Cache-Control ed ETag. Nessuno dei due pagina: un lettore interroga la testa del feed, quindi questi restituiscono solo le voci più recenti, senza cursore.
Il testo della voce è l'HTML sanificato, avvolto in CDATA per RSS e come content_html per JSON Feed, con dentro le tue immagini una volta che le hai attivate. L'immagine di intestazione di una voce è un elemento media:content in RSS e l'immagine dell'item in JSON Feed. JSON Feed porta inoltre i colori delle tue etichette sotto un'estensione con namespace _changelogapp; RSS no, perché nessun lettore li dipingerebbe.
La pagina ospitata li segnala entrambi come link rel="alternate", così un browser o un lettore che vi atterra può iscriversi senza che gli si dicano i percorsi.
Il feed markdown
GET https://api.changeloop.dev/v1/public/YOUR_PUBLIC_ID/changelog.mdLe stesse voci pubblicate come markdown semplice, servite come text/markdown. Esiste per lettori che non sono browser: un LLM o un agente che risponde a cosa è cambiato di recente in questo prodotto riceve il testo senza analizzare RSS o attraversare JSON. Accetta gli stessi filtri repos, category e tag del feed del changelog, ha lo stesso Cache-Control ed ETag, e risponde 304 a una richiesta condizionale esattamente come gli altri due.
Ogni voce è una sezione: il titolo come intestazione, poi una singola riga con data, categoria ed eventuali etichette, poi l'immagine di intestazione come riga di immagine markdown, se la voce ne ha una da un host del tuo elenco, poi il testo della voce, poi il link Learn more se la voce ne ha uno, poi il suo permalink. Il documento inizia con titolo e descrizione del tuo feed e rimanda alla pagina ospitata. Se non è ancora stato pubblicato nulla, lo dice in una frase invece di restituire un corpo vuoto, così chi legge può distinguerlo da una richiesta fallita.
La sitemap
GET https://api.changeloop.dev/v1/public/YOUR_PUBLIC_ID/sitemap.xmlUna sitemap di un solo changelog, per i motori di ricerca: la pagina del changelog e il permalink di ogni voce pubblicata, agli indirizzi che vedono i tuoi lettori, cioè sul tuo dominio una volta che ne hai impostato uno in Impostazioni, Dominio personalizzato. Il lastmod di una voce è la data in cui è stata pubblicata, e quello della pagina è la data della tua voce più recente. Elenca le 1000 voci più recenti, non accetta filtri, ha lo stesso Cache-Control ed ETag dei feed, e risponde 304 a una richiesta condizionale.
Un motore di ricerca non trova questo file da solo, e accetta una sitemap solo per le pagine dell'host che serve il file, oppure quando il file viene inviato per quel sito. Quindi invia questo indirizzo nella tua console di ricerca, per il dominio su cui si trova il tuo changelog.
Il feed del changelog
Le tue voci pubblicate, dalla più recente, con l'id più recente a decidere i pareggi su timestamp identici.
Un changelog a cui abbonarsi
Changeloop scrive ogni voce a partire da una pull request unita, la tiene per la tua revisione e la pubblica insieme nel feed JSON, in RSS, in JSON Feed e in Markdown. Gratis per un repository, senza carta.
Inizia gratis