Add feed endpoints#1242
Open
clementbiron wants to merge 21 commits intomainfrom
Open
Conversation
clementbiron
force-pushed
the
add-feed-endpoints
branch
from
c81ac32 to
d2ed924
Compare
clementbiron
force-pushed
the
add-feed-endpoints
branch
from
d3f3652 to
2582940
Compare
Ndpnt
reviewed
Apr 29, 2026
Ndpnt
reviewed
Apr 29, 2026
Ndpnt
reviewed
Apr 29, 2026
Ndpnt
reviewed
Apr 29, 2026
Ndpnt
reviewed
Apr 29, 2026
Ndpnt
reviewed
Apr 29, 2026
Ndpnt
reviewed
Apr 29, 2026
#34335620 introduced case-insensitive matching on/service/:serviceId, contradicting the documented case-sensitive service ID format
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This pull request adds Atom feed endpoints to the collection API so consumers can subscribe to recent terms updates. A new
/feedendpoint exposes a collection feed, with variants at/feed/:serviceIdand/feed/:serviceId/:termsType.Contrary to what was discussed in #1238, each entry's primary alternate link points to the GitHub commit rather than to the version API. While testing the feed in real readers, a link resolving to a JSON document felt unhelpful for human consumers, who expect to land on a readable page. The version API is still exposed alongside as a related link, so programmatic consumers can discover it from the feed.Update: each entry now exposes a single
alternatelink. By default it points to the version API, which works for any storage backend. Operators who want feed readers to land on a human-readable page can configurecollection-api.feed.versionUrlTemplate(e.g.https://github.com/openTermsArchive/demo-versions/commit/%VERSION_ID); the placeholder is interpolated with the version's identifier.