Package: apigatewaycl
Cliente para realizar la integración con los servicios web deAPI Gatewaydesde Python.Instalación y actualizaciónInstalar usando un entorno virtual y PIP con:python3-mvenvvenvsourcevenv/bin/activatepipinstallapigatewayclActualizar usando PIP con:pipinstallapigatewaycl--upgradeCliente genérico vs clientes específicosEste cliente de API Gateway tiene 2 formas de acceder a los recursos de la API:Cliente genérico: es un cliente que permite consumir de manera sencilla cualquier
recurso de la API. Que actualmente exista o sea añadido en el futuro. Esto se logra
porque el cliente recibe los nombres de los recursos, la parte de la URL que permite
acceder al servicio web solicitado. Se proveen métodos que sólo sirven para acceder
a la API de manera genérica, pero no para hacer acciones específicas ni obtener los
datos en un formato específico. Este cliente es el que entrega mayor flexibilidad, ya
que cada programador decide qué recursos desea consumir y cómo desea obtener los datos.Clientes específicos: son clases que permiten acceder de forma más natural a los
recursos de la API. Al instanciar la clase, se tendrán métodos sencillos con parámetros
para consumir la API. Sin ser necesario preocuparse de recordar o buscar en la
documentación el nombre de los recursos que se deben consumir. Además de entregar los
datos ya “listos” para ser usados en vez de tener que preocuparse de qué método del
cliente genérico usar para obtenerlos en el formato requerido.Autenticación en API GatewayLo más simple, y recomendado, es usar una variable de entorno con eltoken del usuario, la cual será
reconocida automáticamente por el cliente:exportAPIGATEWAY_API_TOKEN="aquí-tu-token-de-usuario"Si no se desea usar una variable de entorno, al instanciar los objetos se
deberá indicar el token del usuario. Ejemplo con el cliente genérico:importapigatewayclAPIGATEWAY_API_TOKEN="aquí-tu-token-de-usuario"client=apigatewaycl.api_client.ApiClient(APIGATEWAY_API_TOKEN)El siguiente es un ejemplo con el cliente específico de Rcv. Primero se pasan
los datos obligatorios de RUT y clave del usuario. Luego además se pasa el token
delusuario de la API.importapigatewayclAPIGATEWAY_API_TOKEN="aquí-tu-token-de-usuario"SII_USUARIO_RUT=""SII_USUARIO_CLAVE=""rcv_client=Rcv(SII_USUARIO_RUT,SII_USUARIO_CLAVE,api_token=APIGATEWAY_API_TOKEN)Si se usan variables de entorno, en ambos ejemplos se puede omitir el argumentoapi_token.LicenciaEste programa es software libre: usted puede redistribuirlo y/o modificarlo
bajo los términos de la GNU Lesser General Public License (LGPL) publicada
por la Fundación para el Software Libre, ya sea la versión 3 de la Licencia,
o (a su elección) cualquier versión posterior de la misma.Este programa se distribuye con la esperanza de que sea útil, pero SIN
GARANTÍA ALGUNA; ni siquiera la garantía implícita MERCANTIL o de APTITUD
PARA UN PROPÓSITO DETERMINADO. Consulte los detalles de la GNU Lesser General
Public License (LGPL) para obtener una información más detallada.Debería haber recibido una copia de la GNU Lesser General Public License
(LGPL) junto a este programa. En caso contrario, consulteGNU Lesser General Public License.EnlacesSitio web API Gateway.Código fuente en GitHub.Paquete en PyPI.Documentación en Read the Docs.