The python SDK for version 2 of the Onspring API is meant to simplify development in Python for Onspring customers who want to build integrations with their Onspring instance.

Installation

Install the SDK using pip:

pip install onspring-api-sdk-python

API Key

In order to successfully interact with the Onspring Api you will need an API key. API keys are obtained by an Onspring user with permissions to at least Read API Keys for your instance via the following steps:

Login to the Onspring instance.
Navigate to Administration > Security > API Keys
On the list page, add a new API Key - this will require Create permissions - or click an existing API key to view its details.
Click on the Developer Information tab.
Copy the X-ApiKey Header value from this tab.

Start Coding

The most common way to use the SDK is to create an OnspringClient instance and call its methods. Its constructor requires two parameters:

baseUrl - currently this should always be: https://api.onspring.com
apiKey - the value obtained by following the steps in the API Key section

It is best practice to read these values in from a configuration file for both flexibility and security purposes.

For example:

import sys
from OnspringClient import OnspringClient
from configparser import ConfigParser

cfg = ConfigParser()
cfg.read('config.ini')

key = cfg['prod']['key']
url = cfg['prod']['url']

client = OnspringClient(url, key)

Full API Documentation

You may wish to refer to the full Onspring API documentation when determining which values to pass parameters to some of the OnspringClient methods. There is also a swagger page that you can use for making exploratory requests.

Example Code

The examples that follow assume you have created an OnspringClient as described in the Start Coding section.

Verify connectivity

canConnect = client.CanConnect()

if canConnect:
    print('Connected successfully')
else:
    print('Attempt to connect failed')