Function: http://rpc.bloglines.com/listsubs
The listsubs function is used to retrieve subscription information for
a given Bloglines account. It requires HTTP Basic authentication, where
the username is the email address of the Bloglines account, and the
password is the same password used to access the account through the
Bloglines web site.
Required Parameters
Optional Parameters
HTTP Status Response
- 200 - normal
- 401 - incorrect email address or password
Payload Response
An "OPML-like" format file is returned. The OPML is augmented with
several additional elements:
- BloglinesSubId
A non-zero unsigned 32-bit integer, representing the unique id for that
subscription or folder. In the case where this number corresponds to a
subscription, it is used as an argument to the getitems function.
- BloglinesUnread
An unsigned 32-bit integer, representing the number of unread entries
for the associated subscription.
- BloglinesIgnore
Either 0 or 1, with 1 indicating that the subscription or folder has been
tagged by the user. Subscriptions with BloglinesIgnore=1 indicate that the
user does not wish to be notified if the subscription has unread entries.
Folders with BloglinesIgnore=1 indicate that the user does not wish to
be notified if any subscription within that folder has unread
entries.
Example Call
http://rpc.bloglines.com/listsubs
Example Response
<?xml version="1.0" encoding="utf-8"?>
<opml version="1.0">
<head>
<title>Bloglines Subscriptions</title>
<dateCreated>Mon, 20 Sep 2004 03:17:38 GMT</dateCreated>
<ownerName>AccountEmailAddress</ownerName>
</head>
<body>
<outline title="Folder Name">
<outline title="Friends" BloglinesSubId="5" BloglinesIgnore="0">
<outline title="Example Blog 1" htmlUrl="http://example.com" type="rss" xmlUrl="http://example.com/rss.xml" BloglinesSubId="2563871" BloglinesUnread="0" BloglinesIgnore="1" />
<outline title="Example Blog 2" htmlUrl="http://example.com/two" type="rss" xmlUrl="http://example.com/two/rss.xml" BloglinesSubId="145448" BloglinesUnread="10" BloglinesIgnore="0" />
</outline>
<outline title="Example Blog 3" htmlUrl="http://example.com/three" type="rss" xmlUrl="http://example.com/three/rss.xml" BloglinesSubId="145448" BloglinesUnread="2" BloglinesIgnore="0"/>
</outline>
</body>
</opml>
|
