Demandbase Python SDK Common Errors, Troubleshooting, and FAQs

Learn how the Demandbase Python SDK reports errors, retries supported failures, handles rate limits and authentication issues, and provides diagnostic information for troubleshooting.

Understand Demandbase Python SDK Error Types

The primary SDK error type is demandbase.DemandBaseAPIError. The SDK raises DemandBaseAPIError when:

• The Demandbase API returns an HTTP error response.
• The SDK prevents a request because required request values are missing.
• A response has an unexpected shape for the requested SDK method.

Network-level errors, including DNS failures, connection failures, and request timeouts, can be raised by the underlying HTTP client. Catch these errors separately if your application requires custom network retry or alerting behavior.

Handle Errors with the Demandbase Python SDK

Catch DemandBaseAPIError when an API request fails. Catch network, timeout, or unexpected application errors separately when your application requires different handling.

import demandbase

try:
    with demandbase.DBClient(timeout=60.0, retry_count=2) as client:
        response = client.b2b_api.list_subscriptions(page=1, per_page=10)
        print(response.model_dump())
except demandbase.DemandBaseAPIError as error:
    print(f"Demandbase API error: {error.http_status_code} - {error.error_message}")
except Exception:
    # Handle network errors, timeouts, or unexpected application errors here.
    raise

Inspect DemandBaseAPIError Details

Use the attributes on DemandBaseAPIError to inspect the failed request and API response.

except demandbase.DemandBaseAPIError as error:
    print(error.request_path)
    print(error.http_status_code)
    print(error.error_message)
    print(error.response_headers)

Configure Automatic Retries in the Demandbase Python SDK

Use the retry_count argument on DBClient to configure retries for supported failures.

import demandbase 

with demandbase.DBClient(retry_count=2) as client: response = client.b2b_api.list_subscriptions()

Handle Demandbase API Rate Limits

If a 429 rate-limit response remains after configured retries are exhausted, catch DemandBaseAPIError and inspect http_status_code, response_headers, and error_message.

Rate-limit header names can vary by API response. Use the returned headers to decide whether your application should retry later, queue the request, or reduce request volume.

except demandbase.DemandBaseAPIError as error:
    if error.http_status_code == 429:
        print("Rate limit reached. Retry later.")
        print(error.response_headers)
    else:
        raise

Demandbase Python SDK Authentication Errors

The SDK reads credentials from the DEMANDBASE_CLIENT_ID and DEMANDBASE_CLIENT_SECRET environment variables. If either value is missing, client initialization raises RuntimeError.

If credentials are invalid or do not provide access to the requested API, the SDK raises DemandBaseAPIError.

Demandbase Python SDK Validation and Exceptions

The SDK validates some inputs before sending requests. Depending on the validation failure, the SDK can raise ValueError, TypeError, or DemandBaseAPIError.

try:
    with demandbase.DBClient() as client:
        client.b2b_api.list_subscriptions(page=0)
except ValueError as error:
    print(f"Invalid request value: {error}")

Protect Sensitive Data in Demandbase Python SDK Logs

SDK logs redact bearer access tokens from authorization headers. Request payloads and query parameters can still contain sensitive business data. Avoid logging full error context in production unless appropriate access controls and retention policies are in place.

import demandbase

demandbase.enable_logging("INFO")

Troubleshoot Common Demandbase Python SDK Issues

Demandbase Python SDK FAQs