SpringServe API Client

0.8.14 verified Sat May 09 auth: no python maintenance

A Python library for interacting with the SpringServe API (console.springserve.com). Current version 0.8.14. Used for programmatic management of supply-side platform operations. Release cadence is irregular, with last update in 2021.

pip install springserve

Common errors

error ImportError: cannot import name 'Client' ↓

cause Incorrect import path; Client is in springserve.client module.

fix

Use 'from springserve.client import Client'

error springserve.exceptions.AuthenticationError: Invalid credentials ↓

cause Incorrect username/password or expired session.

fix

Verify credentials or create a new Client instance.

error AttributeError: 'NoneType' object has no attribute 'list' ↓

cause The client object is None due to failed authentication.

fix

Check that Client() was successfully created and credentials are valid.

Warnings

gotcha The library uses 'requests' internally but does not handle token refresh automatically. Sessions can expire after 24 hours. ↓

fix Reinitialize the Client for long-running scripts or implement manual token refresh.

gotcha Many endpoints return paginated results. The library does not automatically handle pagination. You must iterate over pages manually. ↓

fix Check response for a 'next' or 'page' parameter and loop accordingly.

deprecated Python 2 support is deprecated. Python 3.6+ is recommended. ↓

fix Use Python 3.6 or higher.

Imports

Client
wrong
```
from springserve import Client
```
correct
```
from springserve.client import Client
```
Common mistake: Client is in the client submodule, not top-level.
SpringServe
```
from springserve import SpringServe
```
Top-level class, but rarely used directly; prefer Client.

Quickstart

Initialize a Client with your SpringServe API credentials and list accounts.

from springserve.client import Client

client = Client(
    username='your_username',
    password='your_password'
)
# Test connection by fetching accounts
accounts = client.accounts.list()
print(accounts)