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.