RSS ve JSON Feed
GET https://api.changeloop.dev/v1/public/YOUR_PUBLIC_ID/rss.xmlGET https://api.changeloop.dev/v1/public/YOUR_PUBLIC_ID/feed.jsonYayımlanan aynı kayıtlar, okuyucuların anladığı iki formatta abone olunabilir bir akış olarak: RSS 2.0 ve JSON Feed 1.1. İkisi de changelog akışıyla aynı repos, category ve tag filtrelerini alır ve aynı Cache-Control ile ETag'i taşır. Hiçbiri sayfalanmaz: bir okuyucu akışın başını yoklar, bu yüzden bunlar cursor olmadan yalnızca en son kayıtları döndürür.
Kayıt metni, RSS için CDATA içine sarılmış, JSON Feed için content_html olarak arındırılmış HTML'dir ve görselleri açtığında görsellerin de bunun içindedir. Bir kaydın kapak görseli RSS'te bir media:content elemanı, JSON Feed'de ise öğenin image alanıdır. JSON Feed ayrıca ad alanlı bir _changelogapp uzantısı altında etiket renklerini taşır; RSS taşımaz, çünkü hiçbir okuyucu onları boyamaz.
Barındırılan sayfa ikisini de rel="alternate" bağlantıları olarak duyurur, böylece oraya inen bir tarayıcı veya okuyucu yollar söylenmeden abone olabilir.
Markdown akışı
GET https://api.changeloop.dev/v1/public/YOUR_PUBLIC_ID/changelog.mdYayımlanan aynı kayıtlar, text/markdown olarak sunulan sade markdown hâlinde. Tarayıcı olmayan okuyucular içindir: "bu üründe son zamanlarda ne değişti" sorusuna cevap veren bir LLM veya bir ajan, RSS ayrıştırmadan veya JSON'da gezinmeden metni alır. Changelog akışıyla aynı repos, category ve tag filtrelerini alır, aynı Cache-Control ve ETag'i taşır ve diğer ikisi gibi koşullu bir isteğe 304 ile cevap verir.
Her kayıt bir bölümdür: başlık olarak title, sonra tarihi, kategoriyi ve varsa etiketleri taşıyan tek bir satır, sonra kaydın listendeki bir host'tan gelen bir kapak görseli varsa bir markdown görsel satırı olarak o görsel, sonra kayıt metni, sonra kaydın varsa Learn more bağlantısı, sonra kalıcı bağlantısı. Belge, akış başlığın ve açıklamanla açılır ve barındırılan sayfaya geri bağlanır. Henüz hiçbir şey yayımlanmadığında boş bir gövde döndürmek yerine bunu bir cümlede söyler, böylece bir okuyucu bunu başarısız bir getirmeden ayırt edebilir.
Site haritası
GET https://api.changeloop.dev/v1/public/YOUR_PUBLIC_ID/sitemap.xmlArama motorları için tek bir changelog'un site haritası: changelog sayfası ve yayımlanan her kaydın kalıcı bağlantısı, okuyucularının gördüğü adreslerde, yani Ayarlar, Özel alan adı altında bir alan adı tanımladıysan kendi alan adında. Bir kaydın lastmod değeri yayımlandığı tarihtir, sayfanınki ise en yeni kaydının tarihidir. En yeni 1000 kaydı içerir, filtre almaz, akışlarla aynı Cache-Control ve ETag'i taşır ve koşullu bir isteğe 304 ile cevap verir.
Bir arama motoru bu dosyayı kendiliğinden bulmaz ve bir site haritasını yalnızca dosyayı sunan ana makinedeki sayfalar için ya da dosya o site için gönderildiğinde kabul eder. Bu yüzden bu adresi, changelog'unun bulunduğu alan adı için arama konsolunda gönder.
Changelog akışı
Yayımlanan kayıtların, en yeniden en eskiye, aynı zaman damgasında beraberliği en yeni kimliğin bozduğu hâli.
Abone olunabilen bir changelog
Changeloop her kaydı birleştirilmiş bir pull request'ten yazar, incelemen için bekletir ve aynı anda JSON akışında, RSS'te, JSON Feed'de ve Markdown'da yayınlar. Tek depo için ücretsiz, kart gerekmez.
Ücretsiz başla