Login
Lo primero que debes hacer en tu implementación para empezar a usar el servicio Enlazatte es generar tu token de autenticación, una vez generado tu token, éste tendrá una vigencia de 72 horas
, para generar el token debes realizar una petición tipo POST
para ello debes enviar tu usuario y contraseña a la url base de tu ambiente de pruebas o productivo.
URL Base
La URL base es la dirección de internet que asignaremos a tu servicio Enlazatte, es una dirección personalizada para cada cliente y por medio de ésta el servicio sabe que las peticiones que lleguen ahí serán direccionadas al servidor donde tengas tu sistema Contpaqi.
Ej: http://tu-empresa.enlazatte.com/api-v1
Usuario
Este es el nombre de usuario que asignaremos a tu servicio enlazate, regularmente es tu cuenta de correo electrónico y en todas las generaciones de token que hagas tendrás que enviar éste nombre de usuario.
Ej: juan.perez@tuempres.com
Contraseña
Esta es la contraseña que tendrá asignado tu usuario, de igual forma que el usuario tendrás que enviar ésta contraseña en cada generación de token que hagas.
Ej: TuPSWD#123
Estos 3 datos te los proporcionaremos una vez que realices la contratación del servicio, es lo único que requieres para poder empezar a interactuar desde tu sistema ERP, Punto de Venta, CRM, Producción, etc. con tu sistema Contpaqi.
Request
La petición es una petición tipo POST
, al endpoint /auth/login
, como parámetros del Form envías las credenciales que indica la documentación que son user
y password
, en el encabezado del request se envía el Content-Type
con valor application/x-www-form-urlencoded
.
Una vez generado el Token de autenticación, éste tendrá una vigencia de 72 horas
a partir de su generación, puedes guardar en tu base de datos el token generado y realizar un proceso de actualización de token automático cada 72 horas y con esto optimizar la cantidad de requests y tiempos de espera de tus peticiones ya que no es necesario generar un token para cada petición que haces.
Screenshot Insomnia
¿Listo para empezar?