Kuspit API Starter es un sistema que permite realizar la vinculación de un cliente a Kuspit Casa de Bolsa, siendo ésta la primera parte que se deberá realizar para poder consumir los servicios de la api.
A continuación se explican los pasos a realizar para el proceso de vinculación:
- Solicitar el registro de una empresa cuyo webhook sea http://localhost:8888/webhook (o el puerto configurado en Kuspit API Starter)
- Se descarga, configura, compila y despliega la aplicación Kuspit API Starter, contenida en este repositorio.
- Se accede al endpoint principal de Kuspit API Starter (http://localhost:8888) para ingresar los datos de la empresa.
- Kuspit API Starter abrirá una nueva ventana del navegador con el formulario de vinculación correspondiente a los datos ingresados, a continuación se deberá realizar el proceso de vinculación proporcionando los datos solicitados.
- En el punto final la ventana de vinculación de cliente redirigirá al webhook configurado (en este caso http://localhost:8888/webhook) que estará escuchando Kuspit API Starter.
- Kuspit API Starter cerrará la ventana y con los datos de la empresa y los de vinculación, obtendrá el primer token de acceso del cliente, el cual se mostrará en la ventana principal, con este token se realizarán las acciones posteriores.
La configuración de Kuspit API Starter se encuentra en el archivo application.properties que se encuentra en la ruta src/main/resources/ del directorio de la aplicación.
Dentro de este archivo se encuentran dos propiedades las cuales se pueden configurar:
- com.kuspit.api.url – Corresponde al url donde se encuentra la API OK, el valor será proporcionado por Kuspit Casa de Bolsa al realizar el proceso de registro de la empresa, este campo deberá contener un valor.
- server.port – Es el puerto en el cual se encuentra configurada la ejecución de Kuspit API Starter, por default el valor es 8888, el puerto puede ser modificado si así se desea, este campo deberá contener un valor.
Requerimientos para realizar la compilación de Kuspit API Starter:
- Conexión a internet
- Java JDK 8 o superior
- Maven 3.3 o superior
- Realizar las modificaciones en el archivo application.properties, según la sección anterior.
Una vez que se tenga el código descargado, desde el directorio principal de la aplicación, deberá de ejecutarse el siguiente comando para compilar:
mvn clean install
Si la compilación se realiza de manera correcta, dentro de la carpeta target del proyecto se encontrará un archivo con el nombre starter-1.0.0.jar para ejecutarlo, se deberá de utilizar el siguiente comando:
java -jar starter-1.0.0.jar
Una vez que el sistema se ha ejecutado como se indica en la sección anterior, se podrá acceder en la url: http://localhost:8888 (o el puerto configurado según la siguiente sección). Al acceder a través de un navegador, nos mostrará una pantalla como la siguiente:
En esta pantalla deberemos de dar ingresar los datos de la empresa justo tal y como te los enviamos:
Donde:
- Identificador de Empresa. Es el id que le corresponde a tu empresa, proporcionado por Kuspit.
- Scope. Scope que le corresponde a tu empresa, proporcionado por Kuspit.
- Redirect Uri. Es el valor que se configuró para redirect uri al dar de alta a tu empresa, para utilizar Kuspit API Starter, este deberá de ser http://localhost:8888.
- Client Id. Es el valor de cliente id que se generó durante el proceso de alta de tu empresa, proporcionado por Kuspit.
- Client Secret. Es el valor de client secret que se generó durante el proceso de alta de tu empresa, proporcionado por Kuspit.
- Identificador externo. Es el id que la empresa le asigna al cliente que se va a registrar, este id deberá de ser único para cada uno de los clientes, generado por tu empresa.
- State. Es un campo de control para identificar las peticiones realizadas, es generado por tu empresa.
Una vez que se han ingresado los datos, se procederá a dar clic en el botón “Enviar campos”. Al hacerlo nos mostrará la ventana de vinculación de la API de Kuspit. Es importante mencionar que esta ventana no forma parte de Kuspit API Starter, ya que se está accediendo a la misma a través de la URL configurada en el archivo application.properties:
A partir de este punto se procederá a realizar la vinculación en la nueva ventana:
a) Registra el correo del cliente a vincular:
b) Se enviará un código de activación al correo indicado, ingresa el mismo en esta parte:
c) Escribe una contraseña para acceder y confirma la misma:
d) Al dar clic al botón de vinculación se asociará el cliente a tu empresa y redirigirá al webhook que estableció al incio del proceso (http://localhost:8888/webhook), pasándo como parámetros el code y el status del cliente. Kuspit API Starter mostrará una ventana como la siguiente:
Esta ventana permanecerá durante el tiempo que tome el realizar la petición de primer Token. Al final del proceso se cerrará y se regresará a la ventana principal de Kuspit API Starter, en donde se mostrarán los datos generados durante la vinculación y la obtención de primer token del cliente, éstos serán los que se utilicen para realizar las operaciones de consumo de la API:
- Spring Boot - Framework
- Maven - Administración de dependencias
- Bootstrap - Framework front
- JQuery - Librería Javascript
Cualquier duda, comentario, sugerencia, por favor dirígelas al siguiente correo electrónico: desarrollo@kuspit.com
Version 1.0 - Primera versión del sistema.
Este proyecto está licenciado bajo la licencia MIT - ver el archivo LICENSE.md para más detalles.