Saltar al contenido principal

KintiSoft Python SDK

PyPI Version License: MIT

El SDK oficial de KintiSoft para Python permite integrar la API pública de KintiSoft en aplicaciones backend y servicios Python de forma simple y segura.

Este SDK abstrae​

  • Autenticación
  • Configuración multi-tenant
  • Manejo de errores
  • Comunicación HTTP

Requisitos​

  • PHP 8.1 o superior
  • Composer

Instalación rápida​

composer require kintisoft/sdk

Próximos pasos​

  1. Instala el SDK
  2. Configura autenticación
  3. Ejecuta el Inicio rápido

Instalación (Python)

El SDK de KintiSoft para Python se distribuye a través de pypi y se instala usando pip.

Requisitos:

  • python3

Instalación​

pip install kintisoft-sdk

Autenticación (Python)

La API pública de KintiSoft utiliza API Keys asociadas a un tenant para autenticar las solicitudes.

Credenciales requeridas:

  • tenant: Identificador de tu tenant
  • apiKey: Tu API Key privada

Configuración básica​

from kintisoft_sdk import KintiSoftClient, KintiSoftError

client = KintiSoftClient(
    tenant="acme",
    api_key="pk_live_xxxxxx",
)

Multi-tenant​

El SDK soporta entornos multi-tenant de forma nativa.

Seguridad:

  • No expongas tu API Key en código público
  • Usa variables de entorno cuando sea posible

Inicio rápido (Python)

Este ejemplo muestra cómo crear y listar prospectos usando el SDK de KintiSoft para Python.

Crear un prospecto​

from kintisoft_sdk import KintiSoftClient, KintiSoftError

client = KintiSoftClient(
    tenant="acme",
    api_key="pk_live_xxxxxx",
)

try:
    response = client.prospects.create({
        "contact_name": "Juan Pérez",
        "email": "juan@example.com",
        "phone": "+593999999999",
        "accept_ads": True,
        "comment": "Lead desde Python",
    })

    print(response.get("message"))
except KintiSoftError as exc:
    print(f"Error al crear prospecto: {exc}")
    print(f"Status: {exc.status}")
    print(f"Detalles: {exc.details}")

Manejo de errores​

El SDK lanza KintiSoftError cuando:

  • La API devuelve errores (4xx o 5xx)
  • Hay timeouts
  • Ocurre un problema de red

Opciones avanzadas​

client = KintiSoftClient(
    tenant="acme",
    api_key="pk_live_xxxxxx",
    base_url_override="https://acme.staging.tudominio.com/api/v1",
    timeout=15.0,
)