nexbasira 0.1.2

Python SDK for the NexBasira public API — sessions, evidence, whiteboards, webhooks, branding, custom domains.

nexbasira — Python SDK

Python 3.10+ client for the NexBasira public API. Mirrors the Node SDK's resource surface for ERP/CRM backends written in Python (Odoo, Django, FastAPI).

Install

pip install nexbasira

Quickstart

import os
from nexbasira import NexBasira

nb = NexBasira(
    public_key="nb_pub_...",
    secret=os.environ["NB_SECRET"],
)

# Create a session + mint a field-join URL.
session = nb.sessions.create(notes="Roof inspection — 14 Rue de Lille")
invite = nb.sessions.create_participant_invite(
    session["id"],
    role="field",
    recipient_email="[e-mail]",
)
print(invite["join_url"])

# Iterate evidence (auto-paginated).
for ev in nb.evidence.list(session["id"]):
    print(ev["kind"], ev["sha256"])

# List saved whiteboards.
for wb in nb.whiteboards.list(session["id"]):
    print(wb["id"], wb["byte_size"])

Webhook verification

from nexbasira import construct_event, InvalidSignatureError

@app.post("/nb-webhook")
def handle_webhook(request):
    try:
        event = construct_event(
            request.body,
            request.headers["nb-signature"],
            os.environ["NB_WEBHOOK_SECRET"],
        )
    except InvalidSignatureError:
        return 400
    if event["type"] == "session.completed":
        ...

Errors

NexBasiraError and its subclasses AuthenticationError (401), PermissionError (403), NotFoundError (404), RateLimitError (429, .retry_after_seconds), InvalidSignatureError (webhook).