Autenticación

Crea un QCentroidClient con tu API key de QCentroid:

Puedes generar u obtener tu API key desde la página de perfil de usuario en QCentroid.

from qcentroid_sdk import QCentroidClient

client = QCentroidClient(
    api_key="your-api-key",
)

El SDK se autentica automáticamente cuando necesita realizar la primera llamada a la API.

Usar variables de entorno

El cliente también puede leer la configuración desde variables de entorno:

• QCENTROID_API_KEY
• QCENTROID_TOKEN
• QCENTROID_ENVIRONMENT
• QCENTROID_BASE_URL

Ejemplo:

from qcentroid_sdk import QCentroidClient

client = QCentroidClient()

Si esas variables de entorno están definidas, el cliente las usará automáticamente.

Entorno por defecto

Si no proporcionas un entorno, el SDK usa sandbox por defecto.

client = QCentroidClient(
    api_key="your-api-key",
)

Esto equivale a:

client = QCentroidClient(
    environment="sandbox",
    api_key="your-api-key",
)

Usar un entorno diferente

Por ejemplo, para conectarte al entorno de desarrollo:

client = QCentroidClient(
    environment="dev",
    api_key="your-api-key",
)

Usar un token existente

Si ya tienes un access token, puedes inicializar el cliente directamente con él:

client = QCentroidClient(token="your-access-token")

Cerrar el cliente

El SDK gestiona internamente un cliente HTTP. Puedes cerrarlo explícitamente:

client.close()

O usar un context manager:

with QCentroidClient(
    api_key="your-api-key",
) as client:
    jobs = client.jobs.list(limit=5)