Metadata-Version: 2.4
Name: kintisoft-sdk
Version: 0.1.0
Summary: Official Python SDK for KintiSoft Public API
Author-email: KintiSoft <soporte@kintisoft.com>
License: MIT
Project-URL: Homepage, https://github.com/kintisoft/kintisoft-sdk-python
Project-URL: Source, https://github.com/kintisoft/kintisoft-sdk-python
Project-URL: Issues, https://github.com/kintisoft/kintisoft-sdk-python/issues
Keywords: kintisoft,sdk,api,multitenant
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: License :: OSI Approved :: MIT License
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.31.0
Dynamic: license-file

# kintisoft-sdk (Python)
### SDK oficial de Python para la API pública de KintiSoft

El **SDK oficial de KintiSoft para Python** permite integrar de forma sencilla la API pública de KintiSoft en scripts, aplicaciones backend, servicios y automatizaciones.

Incluye:

- Cliente HTTP listo para producción  
- Manejo de errores con excepciones tipadas  
- Soporte para múltiples tenants  

---

## Instalación

```bash
pip install kintisoft-sdk
```

---

## Configuración básica

```python
from kintisoft_sdk import KintiSoftClient

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

---

## Manejo de errores

El SDK lanza `KintiSoftError` cuando:

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

---

## Opciones avanzadas

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

---

## Estructura interna

```
kintisoft_sdk/
  __init__.py
  client.py
  http_client.py
  prospects.py
  exceptions.py
```

---

## Publicación en PyPI

```bash
python -m build
twine upload dist/*
```

---

## Licencia

MIT License
