kiban-workfloo
API pública de Workfloo: ejecuta un workfloo, consulta su estatus y revisa el historial/detalle de ejecuciones. Todos los endpoints se autentican con el header x-api-key.
Ambientes: producción en https://workfloo.kiban.com y sandbox en https://sandbox.workfloo.kiban.com. El host sandbox activa ese modo de forma implícita y tiene precedencia: ahí el query param sandbox se ignora. Desde el host de producción se puede forzar el modo sandbox por request con sandbox=true.
This Python package is automatically generated by the OpenAPI Generator project:
- API version: 1.0
- Package version: 1.0.0
- Generator version: 7.24.0
- Build package: org.openapitools.codegen.languages.PythonClientCodegen For more information, please visit https://kiban.com
Requirements.
Python 3.10+
Installation & Usage
pip install
If the python package is hosted on a repository, you can install directly using:
pip install git+https://github.com/kiban-cloud/kiban-sdk.git
(you may need to run pip with root permission: sudo pip install git+https://github.com/kiban-cloud/kiban-sdk.git)
Then import the package:
import kiban.workfloo
Setuptools
Install via Setuptools.
python setup.py install --user
(or sudo python setup.py install to install the package for all users)
Then import the package:
import kiban.workfloo
Tests
Execute pytest to run the tests.
Getting Started
Please follow the installation procedure and then run the following:
import kiban.workfloo
from kiban.workfloo.rest import ApiException
from pprint import pprint
# Defining the host is optional and defaults to https://workfloo.kiban.com
# See configuration.py for a list of all supported configuration parameters.
configuration = kiban.workfloo.Configuration(
host = "https://workfloo.kiban.com"
)
# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.
# Configure API key authorization: ApiKeyAuth
configuration.api_key['ApiKeyAuth'] = os.environ["API_KEY"]
# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# configuration.api_key_prefix['ApiKeyAuth'] = 'Bearer'
# Enter a context with an instance of the API client
with kiban.workfloo.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = kiban.workfloo.PoolApi(api_client)
controller_pool_model_execute = kiban.workfloo.ControllerPoolModelExecute() # ControllerPoolModelExecute | Definición del pool y escenarios
sandbox = True # bool | Fuerza el ambiente sandbox. Se ignora en el host sandbox, donde ya es implícito (optional)
try:
# Ejecutar un pool
api_response = api_instance.execute_pool(controller_pool_model_execute, sandbox=sandbox)
print("The response of PoolApi->execute_pool:\n")
pprint(api_response)
except ApiException as e:
print("Exception when calling PoolApi->execute_pool: %s\n" % e)
Documentation for API Endpoints
All URIs are relative to https://workfloo.kiban.com
| Class | Method | HTTP request | Description |
|---|---|---|---|
| PoolApi | execute_pool | POST /api/v1/pool | Ejecutar un pool |
| WorkflooApi | execute_workfloo | POST /api/v1/workfloo | Ejecutar un workfloo |
| WorkflooApi | execute_workfloo_document | POST /api/v1/workfloo/{id}/document | Enviar los documentos de un paso |
| WorkflooApi | execute_workfloo_form | POST /api/v1/workfloo/{id}/form | Enviar el formulario de un paso |
| WorkflooApi | fallback_workfloo_otp | PATCH /api/v1/workfloo/{id}/otp/fallback | Reenviar el código de verificación (OTP) |
| WorkflooApi | get_workfloo | GET /api/v1/workfloo/{id} | Detalle de una ejecución |
| WorkflooApi | get_workfloo_file | GET /api/v1/workfloo/{id}/file | Descargar un archivo de un nodo |
| WorkflooApi | get_workfloo_file_v2 | GET /api/v2/workfloo/{id}/file | Descargar un archivo de un nodo (v2) |
| WorkflooApi | get_workfloo_status | GET /api/v1/workfloo/status/{id} | Estatus de una ejecución |
| WorkflooApi | list_workfloos | GET /api/v1/workfloo | Historial de ejecuciones (v1) |
| WorkflooApi | list_workfloos_v2 | GET /api/v2/workfloo | Historial de ejecuciones (v2) |
| WorkflooApi | resend_workfloo_nip | PATCH /api/v1/workfloo/{id}/nip/resend | Reenviar el NIP |
| WorkflooApi | review_workfloo_validation | POST /api/v1/workfloo/{id}/review | Revisar un paso de validación |
| WorkflooApi | send_workfloo_nip | PATCH /api/v1/workfloo/{id}/nip/send | Enviar el NIP |
| WorkflooApi | submit_workfloo_correction | POST /api/v1/workfloo/{id}/correction | Enviar la corrección de un paso de validación |
| WorkflooApi | validate_workfloo_field | POST /api/v1/workfloo/{id}/field/{fieldId}/validate | Validar un campo del formulario |
| WorkflooApi | validate_workfloo_nip | PATCH /api/v1/workfloo/{id}/nip/validate | Validar el NIP |
| WorkflooApi | validate_workfloo_otp | PATCH /api/v1/workfloo/{id}/otp/validate | Validar el código de verificación (OTP) |
Documentation For Models
- ControllerPoolModelExecute
- ControllerPoolModelExecuteResponse
- ControllerWorkflooDefinitionModelAutoFilledBy
- ControllerWorkflooDefinitionModelDocument
- ControllerWorkflooDefinitionModelField
- ControllerWorkflooDefinitionModelFieldMetadata
- ControllerWorkflooDefinitionModelFieldValidator
- ControllerWorkflooDefinitionModelFileDocument
- ControllerWorkflooDefinitionModelFileDocumentSet
- ControllerWorkflooDefinitionModelFileMetadata
- ControllerWorkflooDefinitionModelForm
- ControllerWorkflooDefinitionModelFormFieldSection
- ControllerWorkflooDefinitionModelSetData
- ControllerWorkflooDefinitionModelSetDataDocument
- ControllerWorkflooDefinitionModelShow
- ControllerWorkflooDefinitionModelShowIf
- ControllerWorkflooModelApi
- ControllerWorkflooModelApiData
- ControllerWorkflooModelApiDataResume
- ControllerWorkflooModelApiHttp
- ControllerWorkflooModelData
- ControllerWorkflooModelDecisionTree
- ControllerWorkflooModelDocumentsResume
- ControllerWorkflooModelEvent
- ControllerWorkflooModelExecute
- ControllerWorkflooModelExecuteResponse
- ControllerWorkflooModelFile
- ControllerWorkflooModelFileResponse
- ControllerWorkflooModelFileResponseV2
- ControllerWorkflooModelForm
- ControllerWorkflooModelFormField
- ControllerWorkflooModelFormResume
- ControllerWorkflooModelLabel
- ControllerWorkflooModelLink
- ControllerWorkflooModelLinkNipStatus
- ControllerWorkflooModelLinkResume
- ControllerWorkflooModelNipResendRequest
- ControllerWorkflooModelNipResendStatus
- ControllerWorkflooModelNipSendErrorStatus
- ControllerWorkflooModelNipSendRequest
- ControllerWorkflooModelNipValidateRequest
- ControllerWorkflooModelNipValidateResponse
- ControllerWorkflooModelNode
- ControllerWorkflooModelNodeDetail
- ControllerWorkflooModelNodeResume
- ControllerWorkflooModelOtpValidateRequest
- ControllerWorkflooModelPdf
- ControllerWorkflooModelRemainingTime
- ControllerWorkflooModelReviewFieldRequest
- ControllerWorkflooModelReviewRequest
- ControllerWorkflooModelReviewResume
- ControllerWorkflooModelRules
- ControllerWorkflooModelRuleset
- ControllerWorkflooModelTimer
- ControllerWorkflooModelValidateFieldRequest
- ControllerWorkflooModelValidateFieldResponse
- ControllerWorkflooModelValidationField
- ControllerWorkflooModelValidationResume
- ControllerWorkflooModelValidationStatus
- ControllerWorkflooModelVariable
- ControllerWorkflooModelVariables
- ControllerWorkflooModelVerificationStatus
- ControllerWorkflooModelWorkfloo
- ControllerWorkflooModelWorkflooListItem
- ControllerWorkflooModelWorkflooPage
- ControllerWorkflooModelWorkflooResume
- ControllerWorkflooModelWorkflooStatus
Documentation For Authorization
Authentication schemes defined for the API:
ApiKeyAuth
- Type: API key
- API key parameter name: x-api-key
- Location: HTTP header
Author
Metadata
Release files for kiban-workfloo 1.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| kiban_workfloo-1.0.0.tar.gz | 71.3 kB | With provenance | Details for kiban_workfloo-1.0.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| kiban_workfloo-1.0.0-py3-none-any.whl | Python 3 | none | any | Details for kiban_workfloo-1.0.0-py3-none-any.whl |
Total release size: 229.7 kB
Release files / kiban_workfloo-1.0.0.tar.gz
| Download URL | kiban_workfloo-1.0.0.tar.gz |
|---|---|
| Size | 71.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b5dd66e2d2afc20e7adfb62aea50198bff0ca168610169bb61db52e9f8d120e7
|
|
BLAKE2b-256 checksum How to use checksums |
c6c692802ff687fbf4fdb02262f58f9e52e6c145d2250891dcb94c67d11bf9cd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 19, 2026.
Transparency logRelease files / kiban_workfloo-1.0.0-py3-none-any.whl
| Download URL | kiban_workfloo-1.0.0-py3-none-any.whl |
|---|---|
| Size | 158.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3c15e2ba9168d0f07397f48e82a9ba50695e99b543a84ff14ebf7cff210eccc5
|
|
BLAKE2b-256 checksum How to use checksums |
13c7e2c92d92c89f481a3830a80e358958720ec37ed1b8979b6226bc3e5b2623
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 19, 2026.
Transparency logSecurity for kiban-workfloo 1.0.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for kiban_workfloo-1.0.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 19, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.