RSS와 JSON Feed
GET https://api.changeloop.dev/v1/public/YOUR_PUBLIC_ID/rss.xmlGET https://api.changeloop.dev/v1/public/YOUR_PUBLIC_ID/feed.json동일한 게시된 항목을 독자가 이해하는 두 가지 형식, 즉 RSS 2.0과 JSON Feed 1.1로 구독 가능한 피드로 제공합니다. 둘 다 changelog 피드와 동일한 repos, category, tag 필터를 받아들이고 동일한 Cache-Control과 ETag를 가집니다. 어느 쪽도 페이지네이션하지 않습니다: 독자는 피드의 맨 앞을 폴링하므로, 이들은 커서 없이 가장 최근 항목만 반환합니다.
항목 텍스트는 새니타이즈된 HTML이며, RSS에서는 CDATA로 감싸이고 JSON Feed에서는 content_html로 제공됩니다. 이미지를 켜면 여러분의 이미지도 그 안에 포함됩니다. 항목의 헤더 이미지는 RSS에서는 media:content 요소로, JSON Feed에서는 항목의 image로 제공됩니다. JSON Feed는 추가로 네임스페이스가 지정된 _changelogapp 확장 아래 여러분의 태그 색상을 포함하지만, RSS는 포함하지 않습니다. 그것들을 칠할 독자가 없기 때문입니다.
호스팅된 페이지는 둘 다를 rel="alternate" 링크로 광고하므로, 그곳에 도달한 브라우저나 독자는 경로를 알려주지 않아도 구독할 수 있습니다.
markdown 피드
GET https://api.changeloop.dev/v1/public/YOUR_PUBLIC_ID/changelog.md동일한 게시된 항목을 text/markdown으로 제공되는 순수 markdown으로 제공합니다. 이는 브라우저가 아닌 독자를 위해 존재합니다: '이 제품에서 최근 무엇이 바뀌었나요'에 답하는 LLM이나 에이전트는 RSS를 파싱하거나 JSON을 탐색하지 않고 텍스트를 얻습니다. changelog 피드와 동일한 repos, category, tag 필터를 받아들이고, 동일한 Cache-Control과 ETag를 가지며, 다른 둘과 정확히 같은 방식으로 조건부 요청에 304로 응답합니다.
각 항목은 하나의 섹션입니다: 제목이 표제로, 그다음 날짜, 카테고리, 태그를 담은 한 줄, 그다음 항목에 목록의 호스트에서 가져온 헤더 이미지가 있다면 markdown 이미지 줄로 된 그 이미지, 그다음 항목 텍스트, 그다음 항목에 있다면 Learn more 링크, 그다음 영구 링크. 문서는 여러분의 피드 제목과 설명으로 시작하며 호스팅된 페이지로 다시 연결됩니다. 아직 아무것도 게시되지 않았다면, 빈 본문을 반환하는 대신 한 문장으로 그것을 말하므로 독자는 이를 실패한 가져오기와 구별할 수 있습니다.
사이트맵
GET https://api.changeloop.dev/v1/public/YOUR_PUBLIC_ID/sitemap.xml검색 엔진을 위한, 하나의 changelog에 대한 사이트맵입니다. changelog 페이지와 게시된 각 항목의 영구 링크를 독자가 보는 주소로 담습니다. 설정, 사용자 지정 도메인에서 도메인을 설정했다면 그 자체 도메인의 주소가 됩니다. 항목의 lastmod는 게시된 날짜이고, 페이지의 lastmod는 가장 최근 항목의 날짜입니다. 최신 항목 1000개를 담고, 필터는 받지 않으며, 피드와 동일한 Cache-Control과 ETag를 가지고, 조건부 요청에 304로 응답합니다.
검색 엔진은 이 파일을 스스로 찾지 못하며, 사이트맵은 그 파일을 제공하는 호스트의 페이지에 대해서만, 또는 해당 사이트용으로 제출된 경우에만 받아들입니다. 따라서 changelog가 있는 도메인에 대해 이 주소를 서치 콘솔에 제출하세요.
changelog 피드
게시된 항목을 최신 순으로 제공하며, 동일한 타임스탬프의 경우 최신 ID로 동점을 결정합니다.