Dopplr Developer Wiki

This wiki is where the Dopplr API will be developed and iterated upon in public. Documentation, examples and mashups to come.

Dopplr API documentation

API Resource URLs

The API is based on Google AuthSub. It goes like this:

1. When you first work with a user, send them to a URL like https://www.dopplr.com/api/AuthSubRequest?scope=http://www.dopplr.com&next=url&session=1 where url is a URL that your app can handle.
2. The user gets a proper description of what they're agreeing to and an explanation of how to revoke the permission later.
3. If they agree, their browser will be directed to url with ?token=123456 appended. Your code on that page should remember the token. It's good for one call to the API.
4. Use the token to call /api/AuthSubSessionToken and it'll return a document containing a new 'infinite use' session token (of the kind that's returned by the api_session_token page you're using now). Remember this token and use it with all future API calls for this user.

Going through this process means that a) the user has really agreed to what's going on and b) the only token that passes through the user's browser (and hence their potentially-insecure browser history) is a one-use token that can't be used to manipulate their account by anyone else.

We intend to replace this AuthSub clone implementation with OAuth in the near future.

Example clients

• Prototype PHP Client
• Prototype Perl Client Library
• clientside with javascript
• C# Example (Dottlr project)
• Actionscript 3 Client Library
• Ruby client

SSL

All communications with the API go through SSL for privacy.

Editing the wiki

Use the password travel to edit this wiki.

Token management

There's a very simple token management interface at http://www.dopplr.com/account/tokens where you can revoke/unrevoke tokens. Activities performed via a token will be associated with that token, and visible from the traveller Journal.

Getting a token for testing purposes

Visit http://www.dopplr.com/account/api_session_token to generate a token.

Questions

1. I want to know which of my friends on Facebook is also on Dopplr. How can I get this information?
2. I want to pull information about trips to a particular location for a facebook app I'm building. My user is planning a trip to, say, Srinagar and wants to know which of his friends on Facebook has been there already or lives there. How do I get this via the api?