Overview

Feeds are simple read-only endpoints to access Dropmark data for personal use.

Authentication

Authentication is required for most calls, with exception to public collections. Two forms of authentication are supported:

1. Basic auth using email (or username) and password.
2. Personal, read-only API keys.

Personal keys can be obtained under Collection Settings > Advanced > JSON or Account > Private links > Activity feed, depending on the desired endpoint. Keys are unique for each endpoint and collection, and can be reset at any time (from Account > Private links).

Endpoints

1. Collection

Retrieves items within a specific collection. Use the following URL, replacing :id for the numeric collection ID requested and username with a valid username.

https://username.dropmark.com/:id.json

Supported parameters:

• JSON (.json)
• Podcast-friendly RSS (.rss or .xml)
• Comma-separated values (.csv)
• Playlist file (.pls)

Supported parameters:

• key - personal read-only token (optional with basic auth)
• callback - include for JSONP requests (optional)

Note: Authentication is only required for private collections.

Curl example:

curl --user "username:password" "https://username.dropmark.com/1234.json"

JavaScript example:

$.getJSON("https://username.dropmark.com/1234.json?key=abc123&callback=?", function(data) {
   data.items.map(...);
});

2. Activity

Retrieves a blended feed of newly created collections, items, comments, and reactions for a particular user or team. Use the following URL, replacing username with a valid username.

https://username.dropmark.com/activity.json

Supported formats:

• JSON (.json)
• RSS (.rss or .xml)

Supported arguments:

• key - personal read-only token (optional with basic auth)

Curl example:

curl --user "username:password" "https://username.dropmark.com/activity.json"

JavaScript example:

$.getJSON("https://username.dropmark.com/activity.json?key=abc123&callback=?", function(data) {
   data.map(...);
});