Official Airfree SDKs for Python, TypeScript, Go, and Java handle authentication, retries, and typed responses so you can skip the boilerplate.
The Airfree SDKs wrap the platform APIs with idiomatic clients for each language. They handle the OAuth token lifecycle, automatic retries with back-off, and typed request and response models, so most integrations never touch a raw HTTP call.
Available languages
- Python — pip install airfree, with async and sync clients.
- TypeScript / JavaScript — npm install @airfree/sdk, isomorphic (browser and Node).
- Go — go get github-equivalent module distributed through the platform registry.
- Java — available through the platform Maven repository.
Example: Python
The client is configured once with your credentials; token acquisition and refresh are automatic.
from airfree import Client
client = Client(
base_url="https://airfree.au",
client_id="your-client",
client_secret="...", # server-side only
)
collections = client.ogc.collections.list()
for c in collections:
print(c.id, c.title)Example: TypeScript
import { AirfreeClient } from '@airfree/sdk';
const client = new AirfreeClient({ baseUrl: window.location.origin });
const parcels = await client.cadastre.parcels.list();
console.log(parcels.length);Conventions
All SDKs share the same conventions: resources are namespaced by service, errors carry the platform’s trace reference for support, and pagination is handled by iterators. Pin a major version and read the changelog before upgrading.