Twitgram - Deliver private messages to anyone on Twitter
Tweetmarks - a web service for setting and getting the "last read" tweet for a given Twitter user
Tweetmarks is a web service for setting and getting the "last read" tweet for a given Twitter user. It can be used to "sync" the reading position between multiple Twitter clients and platforms. It was created by Riverfold Software. Also see this blog post introducing the service.
The API currently piggybacks on Heroku's SSL cert, but will eventually switch to api.tweetmarks.net. All calls take a required "api_key" parameter. Contact manton@riverfold.com to request one.
POST https://tweetmarks.heroku.com/v1/lastread?collection=timeline
This uses OAuth Echo to verify a user's account, just like when posting an image to Twitpic. If you are already doing image upload with OAuth Echo, you may be able to reuse the headers you create exactly, just pass them to a different URL.
X-Verify-Credentials-Authorization should be constructed in the usual way with secret keys etc.
X-Auth-Service-Provider should be: https://api.twitter.com/1/account/verify_credentials.json
More info here: http://dev.twitter.com/pages/oauth_echo
The body of the POST is the status ID of the tweet you want to save. This should be the tweet that is currently visible at the top of your view. If scrolled, this might not be the most recent tweet. Other clients will then refresh and scroll this saved tweet (if it's found) so that it's also visible at the top of the view.
The "collection" parameter is optional but if not set will default to "timeline". If should be one of these: timeline, mentions, messages (for DMs), favorites, or e.g. 37signals/staff (for lists). But it can be anything, if you have special groups of tweets that you want to sync.
Clients should make this call when a user is switching views or quitting the app. Don't call too often, and be prepared to gracefully fail.
GET http://tweetmarks.heroku.com/v1/lastread?collection=timeline&username=manton
Same as above but doesn't require authentication, so just pass an extra username parameter.
Returns the status ID for the last saved tweet in the HTTP body.
Clients should quietly fail if this call returns a non-200 HTTP response or times out. Do not show an error message, just restore the scrolled position as you normally would without the synced status ID.
GET http://tweetmarks.heroku.com/v1/show?username=manton
Not an API, just a quick way in a web browser to see what data is being set. Pass a username parameter for the user to filter.
