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
The API is based on Google AuthSub. It goes like this:
- 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.
- The user gets a proper description of what they're agreeing to and an explanation of how to revoke the permission later.
- 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.
- 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 Ruby Client- Improved Ruby Client
- Prototype PHP Client
- Prototype Perl Client Library
- clientside with javascript
- Erlang Example
- C# Example (Dottlr project)
- Actionscript 3 Client Library
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.
Page Information
|
Wiki Information |
Recent PBwiki Blog Posts |
Create your own business wiki!