Skip to content

Python sample

controlled developer access. Store the application secret in your server secret manager. Never ship it to browser or mobile code.

This executable sample proves canonical vault reads, pagination parameters, and server-side bearer authentication with a deterministic test transport.

Complete source

from __future__ import annotations

import json

from torq_sdk import TorqClient, TorqClientConfig


class Response:
    def __enter__(self) -> "Response":
        return self

    def __exit__(self, *_args: object) -> None:
        return None

    def read(self) -> bytes:
        return json.dumps(
            {
                "items": [{"id": "vault_1"}],
                "pageInfo": {"hasMore": False, "nextCursor": None},
                "freshness": {"status": "current", "lagSeconds": 0},
            }
        ).encode()


observed: dict[str, str] = {}


def transport(request: object, _timeout: float) -> Response:
    observed["url"] = request.full_url
    observed["authorization"] = request.headers["Authorization"]
    return Response()


client = TorqClient(
    TorqClientConfig(
        base_url="https://api.example.test",
        secret_key="torq_test_sk_external_quickstart",
        transport=transport,
    )
)
vaults = client.list_resource("vaults", limit=1)
assert vaults["items"][0]["id"] == "vault_1"
assert observed["url"] == "https://api.example.test/v1/vaults?limit=1"
assert observed["authorization"] == "Bearer torq_test_sk_external_quickstart"
print("Python Torq SDK quickstart passed.")

Configure the approved Torq base URL and reconcile the returned freshness evidence before showing balances or availability to a customer.