Skip to content
Michael Rhodes edited this page Oct 16, 2013 · 8 revisions

Pond API Documentation

Work in progress. Contributions are welcome.

This is mostly just an outline.

Subscriptions

POST /subscriptions

Subscribes the user to a feed.

Takes a URL via a form parameter and performs auto–discovery of feeds.

Returns a JSON array containing the latest entries of the feed (?)

Response

Status Code Explanation Content
201 The subscription was created successfully null
400 The request was malformed. The url form parameter was probably omitted null
409 The subscription already exists null
500 Internal server error null

GET /subscriptions

Returns a JSON array of the user's subscriptions

GET /subscriptions/:id

Returns information about the subscription with id :id

DELETE /subscriptions/:id

Unsubscribes the user from a feed.

Deletes the subscription with id :id

Articles

GET /subscriptions/articles

Returns all of the users articles, properly sorted and filtered according to the query parameters (e.g. only unread items, since a specific date or previous item, etc.)

GET /subscriptions/:subscriptionid/articles

Returns all articles properly sorted and filtered according to the query parameters, from a specific feed.

PUT /subscriptions/:subscriptionid/articles/:articleid

Updates the article with id :articleid from feed with id :subscriptionid (e.g. to mark it as read)

Favorites

POST /favorites

Marks articles as favorites

Takes a JSON array of articles with a length of >= 1

GET /favorites

Returns a list of the user's favorites

DELETE /favorites/:id

Unfavorites the article with id :id