RSS i JSON Feed
GET https://api.changeloop.dev/v1/public/YOUR_PUBLIC_ID/rss.xmlGET https://api.changeloop.dev/v1/public/YOUR_PUBLIC_ID/feed.jsonTe same opublikowane wpisy jako feed do subskrypcji, w dwóch formatach zrozumiałych dla czytników: RSS 2.0 i JSON Feed 1.1. Oba przyjmują te same filtry repos, category i tag co feed changeloga i niosą ten sam Cache-Control i ETag. Żaden nie paginuje: czytnik odpytuje początek feedu, więc te zwracają tylko najnowsze wpisy, bez kursora.
Tekst wpisu to zsanityzowany HTML, opakowany w CDATA dla RSS i jako content_html dla JSON Feed, z Twoimi obrazami w środku, gdy włączysz obrazy. Obraz nagłówka wpisu to element media:content w RSS i pole image elementu w JSON Feed. JSON Feed dodatkowo niesie kolory Twoich tagów pod rozszerzeniem z przestrzenią nazw _changelogapp; RSS nie, ponieważ żaden czytnik by ich nie pomalował.
Hostowana strona reklamuje oba jako linki rel="alternate", więc przeglądarka lub czytnik, który tam trafi, może zasubskrybować bez podawania ścieżek.
Feed markdown
GET https://api.changeloop.dev/v1/public/YOUR_PUBLIC_ID/changelog.mdTe same opublikowane wpisy jako zwykły markdown, serwowany jako text/markdown. Istnieje dla czytników, które nie są przeglądarkami: LLM lub agent odpowiadający na "co ostatnio zmieniło się w tym produkcie" dostaje tekst bez parsowania RSS lub przechodzenia po JSON. Przyjmuje te same filtry repos, category i tag co feed changeloga, niesie ten sam Cache-Control i ETag, i odpowiada 304 na żądanie warunkowe dokładnie jak dwa pozostałe.
Każdy wpis to sekcja: tytuł jako nagłówek, potem jedna linia z datą, kategorią i wszelkimi tagami, potem obraz nagłówka jako linia obrazu w markdownie, jeśli wpis ma taki obraz z hosta z Twojej listy, potem tekst wpisu, potem link Learn more, jeśli wpis go ma, potem jego stały link. Dokument zaczyna się tytułem i opisem Twojego feedu i prowadzi z powrotem do hostowanej strony. Gdy nic jeszcze nie zostało opublikowane, mówi to w jednym zdaniu zamiast zwracać pustą treść, więc czytnik może odróżnić to od nieudanego pobrania.
Sitemap
GET https://api.changeloop.dev/v1/public/YOUR_PUBLIC_ID/sitemap.xmlSitemap jednego changeloga, dla wyszukiwarek: strona changeloga i stały link każdego opublikowanego wpisu, pod adresami, które widzą czytelnicy, czyli w twojej własnej domenie, gdy ustawisz ją w Ustawieniach, sekcja Własna domena. Wartość lastmod wpisu to data jego publikacji, a strony to data twojego najnowszego wpisu. Zawiera 1000 najnowszych wpisów, nie przyjmuje filtrów, niesie ten sam Cache-Control i ETag co feedy i odpowiada 304 na żądanie warunkowe.
Wyszukiwarka nie znajdzie tego pliku sama i przyjmuje sitemap tylko dla stron na hoście, który serwuje plik, albo gdy plik zostanie zgłoszony dla tej witryny. Zgłoś więc ten adres w swojej konsoli wyszukiwarki, dla domeny, w której jest twój changelog.
Feed changeloga
Twoje opublikowane wpisy, od najnowszych, z najnowszym identyfikatorem rozstrzygającym remisy przy identycznych znacznikach czasu.
Changelog, który można subskrybować
Changeloop tworzy każdy wpis z połączonego pull requesta, zatrzymuje go do twojego przeglądu i publikuje naraz w kanale JSON, w RSS, w JSON Feed i w Markdownie. Za darmo dla jednego repozytorium, bez karty.
Zacznij za darmo