RSS en JSON Feed
GET https://api.changeloop.dev/v1/public/YOUR_PUBLIC_ID/rss.xmlGET https://api.changeloop.dev/v1/public/YOUR_PUBLIC_ID/feed.jsonDezelfde gepubliceerde items als abonneerbare feed, in de twee formaten die feedlezers begrijpen: RSS 2.0 en JSON Feed 1.1. Beide accepteren dezelfde filters repos, category en tag als de changelog-feed en dragen dezelfde Cache-Control en ETag. Geen van beide pagineert: een lezer vraagt de kop van de feed op, dus deze geven alleen de meest recente items terug, zonder cursor.
De tekst van het item is de opgeschoonde HTML, verpakt in CDATA voor RSS en als content_html voor JSON Feed, met je afbeeldingen erin zodra je afbeeldingen hebt aangezet. De headerafbeelding van een item is een media:content-element in RSS en de afbeelding van het item in JSON Feed. JSON Feed draagt daarnaast de kleuren van je tags onder een namespaced _changelogapp-extensie; RSS niet, omdat geen lezer die zou tekenen.
De gehoste pagina kondigt beide aan als rel="alternate"-links, zodat een browser of lezer die daar landt zich kan abonneren zonder dat de paden hoeven te worden meegedeeld.
De markdown-feed
GET https://api.changeloop.dev/v1/public/YOUR_PUBLIC_ID/changelog.mdDezelfde gepubliceerde items als gewone markdown, aangeboden als text/markdown. Het bestaat voor lezers die geen browsers zijn: een LLM of agent die antwoordt op wat er onlangs in dit product is veranderd, krijgt de tekst zonder RSS te parsen of JSON te doorlopen. Het accepteert dezelfde filters repos, category en tag als de changelog-feed, draagt dezelfde Cache-Control en ETag, en reageert net als de andere twee met 304 op een voorwaardelijk verzoek.
Elk item is een sectie: de titel als kop, dan één regel met datum, categorie en eventuele tags, dan de headerafbeelding als markdown-afbeeldingsregel als het item er een heeft van een host op je lijst, dan de itemtekst, dan de Learn more-link als het item er een heeft, dan de permalink ervan. Het document begint met de titel en beschrijving van je feed en linkt terug naar de gehoste pagina. Als er nog niets is gepubliceerd, staat dat in een zin in plaats van een lege body terug te geven, zodat een lezer dit kan onderscheiden van een mislukt verzoek.
De sitemap
GET https://api.changeloop.dev/v1/public/YOUR_PUBLIC_ID/sitemap.xmlEen sitemap van één changelog, voor zoekmachines: de changelogpagina en de permalink van elk gepubliceerd item, op de adressen die je lezers zien, dus op je eigen domein zodra je er een hebt ingesteld onder Instellingen, Eigen domein. De lastmod van een item is de datum waarop het is gepubliceerd, en die van de pagina is de datum van je nieuwste item. Hij bevat de nieuwste 1000 items, accepteert geen filters, draagt dezelfde Cache-Control en ETag als de feeds, en reageert met 304 op een voorwaardelijk verzoek.
Een zoekmachine vindt dit bestand niet vanzelf, en accepteert een sitemap alleen voor pagina's op de host die het bestand serveert, of wanneer het bestand voor die site wordt ingediend. Dien dit adres dus in bij je zoekconsole, voor het domein waarop je changelog staat.
De changelog-feed
Je gepubliceerde items, nieuwste eerst, waarbij de recentste id de doorslag geeft bij identieke tijdstempels.
Een changelog waarop je je kunt abonneren
Changeloop stelt elke entry op uit een gemergede pull request, houdt hem vast voor jouw review en publiceert hem tegelijk in de JSON-feed, als RSS, als JSON Feed en als Markdown. Gratis voor één repository, zonder kaart.
Gratis starten