SDKs
Official SDKs cover every API-key-authenticated endpoint documented here. Pick the language that fits your project - both share the same mental model and method names (translated snake_case ↔ camelCase).
Install
pip install nopaqueQuick start
from nopaque import Nopaque
client = Nopaque(api_key="nq_...") # or set NOPAQUE_API_KEY
# Create a mapping job and wait for completion
job = client.mapping.create(
name="Main IVR",
phone_number="+441234567890",
mapping_mode="dtmf",
)
client.mapping.start(job.id)
final = client.mapping.wait_for_complete(job.id)
print(final.status)
client.close()Client configuration
All options are optional unless you aren't using the environment variable. Both SDKs read NOPAQUE_API_KEY and NOPAQUE_BASE_URL automatically.
Nopaque(
api_key="nq_...", # or env NOPAQUE_API_KEY
base_url="https://api.nopaque.co.uk", # or env NOPAQUE_BASE_URL
timeout=60.0, # seconds
max_retries=3, # set to 0 to disable
default_headers={"X-Source": "worker"},
)Authentication
Both SDKs use the workspace API key in the x-api-key header. See Authentication for how to create a key and tier restrictions.
Method reference
There is no separate SDK method index. Every endpoint page under Endpoints shows the Python and TypeScript call for that operation alongside the cURL form, so the endpoint reference doubles as the SDK reference. Use the language tabs on any example to switch.
Common patterns
- Pagination - list endpoints return auto-following iterators.
- Polling long-running jobs -
wait_for_complete/waitForCompleteon mapping, testing, batches, sweeps, load tests. - Audio upload & download - one-call helpers wrap the presigned-URL flow.
- Errors - typed exception hierarchy with per-status subclasses.
- Rate limits - SDKs auto-retry 429 with
Retry-After.