CLI Usage

Install with pip install misfit

Create an app with “Application Domain” set to http://127.0.0.1:8080/. Now use the “App key” and “App secret” in the following command:

misfit authorize --client_id=<app_key> --client_secret=<app_secret>

That will save the necessary credentials for making further API calls to a file called “misfit.cfg”. These credentials should be kept private. You can use same the command-line client to access everything in the Resource API. You can also access the same resources using the Python API:

>>> from misfit import Misfit
>>> misfit = Misfit(<client_id>, <client_secret>, <access_token>)
>>> print(misfit.profile())
{u'gender': u'male', u'birthday': u'1981-07-18', u'userId': u'scrubbed', u'name': u'Brad Pitcher'}

API Usage

After you have installed and created your misfit app you can authorize and use the API with your own web server rather than the built-in CherryPy server like so:

>>> from misfit.auth import MisfitAuth
>>> auth = MisfitAuth(<client_id>, <client_secret>, redirect_uri=<redirect_uri>)
>>> auth_url = auth.authorize_url()

Now redirect the user to auth_url. When control returns to your web server at the endpoint specified in <redirect_uri>, you will receive code and state GET params you can pass to the fetch_token method, which will return access_token, which is needed for further API calls:

>>> access_token = auth.fetch_token(<code>, <state>)
>>> from misfit import Misfit
>>> misfit = Misfit(<client_id>, <client_secret>, <access_token>)
>>> print(misfit.profile())
{u'gender': u'male', u'birthday': u'1981-07-18', u'userId': u'scrubbed', u'name': u'Brad Pitcher'}