Feeds
Posted in Technical by JarrettV on 8/29/2008 8:33:32 PM - CSTOverview
Feeds are the heart and soul of AtomSite. The service supports collection feeds.
Collection Resources MUST provide representations in the form of Atom Feed Documents whose Entries contain the IRIs of the Members in the Collection. No distinction is made between Collection Feeds and other kinds of Feeds -- a Feed might act both as a 'public' feed for subscription purposes and as a Collection Feed. --Section 10 of Atom Publishing Protocol Specification
AtomSite does make a distinction as 'private' feeds are available only to authorized users and may contain private data. These 'private' collection feeds are not meant for syndication. However, the public feeds generated in both Atom and RSS formats are perfect for syndication.
AtomSite also supports public annotation feeds at either the collection or entry level.
Feed Examples
Private |
Collection Feed | http://atomsite.net/info.atom |
Public |
Atom Feed | http://atomsite.net/info/feed.atom |
Public |
RSS Feed | http://atomsite.net/info/feed.rss |
Public |
Annotations Atom Feed | http://atomsite.net/info/annotations.atom |
Public |
Annotations RSS Feed | http://atomsite.net/info/annotations.rss |
Public |
Annotations Atom Feed | http://atomsite.net/blog/2008/08/08/Entry/annotations.atom |
Public |
Annotations RSS Feed | http://atomsite.net/blog/2008/08/08/Entry/annotations.rss |
Note: AtomSite now removes email addresses in public feeds to prevent spam.
Paging
Feeds support paging using a query string parameter.
For example: http://atomsite.net/blog/feed.atom?page=2
Control
Public feeds can be controlled by modifying the configuration setting called syndicationOn on the collection.
- syndicationOn
- true = public syndication feeds are on
- false = public syndication feeds are off
Private
Public
Public