Python SDK¶

pip install nimbus-sdk

Initializing the client¶

from nimbus import Client

client = Client(api_key="YOUR_API_KEY")

Creating a record¶

client.buckets.records.create(
    bucket="my-first-bucket",
    name="hello-world",
    value=42,
)

Pagination¶

The client returns an iterator that transparently fetches subsequent pages — see Pagination for the underlying API behavior.

for record in client.buckets.records.list(bucket="my-first-bucket"):
    print(record.name, record.value)

Error handling¶

from nimbus.errors import NimbusAPIError

try:
    client.buckets.records.get(bucket="my-first-bucket", name="missing")
except NimbusAPIError as e:
    print(e.code, e.message, e.request_id)

Retries

The Python SDK retries 429 and 5xx responses automatically using the strategy described in Rate Limiting & Retries.