Authentication

API access

The TrueZone API runs as a managed cloud service. To get started:

1. Contact us at driftline.io/contact to request API credentials
2. We'll provision a dedicated API key or service account for your organization
3. You'll receive your endpoint URL and authentication details

Authentication method

All API requests use bearer token authentication:

curl -X POST $YOUR_ENDPOINT -H "Authorization: Bearer $YOUR_TOKEN" -H "Content-Type: application/json" -d '{"settings":"...","data":"..."}'

Tokens and endpoint details are provided during onboarding.

Request format

Both settings and data are stringified JSON strings inside the outer JSON object. This matches the SDK's native format. See Input Format for the full schema.

Rate limits

• Timeout: 300 seconds per request
• Payload: no hard limit on session length (marathons, multi-hour rides are fine)
• Concurrency: managed per-partner

Alternative: run on your infrastructure

If you prefer to run the SDK on your own servers, two options are available. Both require a license agreement.

WASM / npm package

Run in Node.js or the browser:

import { analyse } from '@driftline/sdk';
const result = await analyse(inputJson);

C++ SDK

For maximum performance, compile and link the C++ SDK directly into your application.

Both options produce identical outputs to the API — same parameters, same derived metrics. Contact us for licensing and access.