Active Collab API

Note: I have tested this API against the Cloud-Hosted version of Active-Collab, not with the self-hosted installation!

Useful links

• https://developers.activecollab.com/api-documentation/index.html
• https://github.com/activecollab/activecollab-feather-sdk
• https://stackoverflow.com/questions/tagged/activecollab

Workflow

1. Login with username and password to Authentication Server and get back the intent for the user
2. Request a token for some Account (user could have multiple accounts) using the Account url and the users intent
3. Use the token to authenticate for every other API-Call

Example login:

auth = ACAuthenticator()
session = auth.login(username, password)
pprint(session)
user = session['user']
# use first account
account = auth.find_account(account_name)

Example request token

token = ACTokenAuthenticator(account, user).issue_token_intent()
pprint(token)

Example client request

ac = ACClient(account, token)
res = ac.get_projects()
pprint(res.json())

Configuration

config.ini:

[LOGIN]
username = you@example.com
password = very-secret
account_name = "#123456"