/python-upwork

Python bindings for Upwork API

Primary LanguagePythonApache License 2.0Apache-2.0

License PyPI version GitHub release Build status

Copyright (c) 2010-2015, Upwork http://www.upwork.com All rights reserved.

Upwork API

These are Python bindings for Upwork Public API https://developers.upwork.com/ You can use the API to build apps that will help you:

  • Manage your distributed team
  • Search for contractors and jobs
  • Send bulk invitations to interview and make offers
  • Work with Messages workflow
  • Retrieve Time & Financial information for your company, team and contractors

The API is the best way to communicate between apps.

Requirements

httplib2==0.9 oauth2==1.5.211 urllib3==1.10 httplib2.system-ca-certs-locater==0.1.1

Installation

pip install python-upwork

All the dependencies will be automatically installed as well.

SSL Certificates Note

We recommend installing the package httplib2.system_ca_certs_locater (it is installed by default during python_upwork installation):

pip install pbr httplib2.system_ca_certs_locater

It will force httplib2 to use the OS's certificates file.

If you want to use your own certificates, introduce the following code during initialization:

os.environ['HTTPLIB_CA_CERTS_PATH'] = '/path/to/my/ca_certs.txt'

Quick start

First, you need to create an API key for the authorization process here: https://www.upwork.com/services/api/keys

Installing Ipython interactive shell is very useful for working with the API. It offers features such as auto complete, history and docstring help display if you add '?' to the end of the variable/function/class/method among other interesting functionalities. So we really encourage you to install this shell: pip install ipython

To get started, look at the docs http://upwork.github.io/python-upwork/how_to.html and also look at the examples/ folder to see examples how to obtain oauth access tokens for web application and desktop application.

Useful Links