Autenticación
Factura Electónica
- Compras
- Ventas
- Comunas
- Clientes
- Proveedores
- Productos
- Sucursales
Contabilidad
- Comprobantes
Partners
- Compras
- Pagos
- Recaudaciones
- Ventas

Auntenticación

El proceso de autenticación es utilizado para asegurar el uso integro y confiable de la información, en esta sección aprenderás como autenticarte en la API de Nubox.

Flujo de Autenticación

Autenticandonos en la API nubox

Lo primero es concatenar nuestro usuario y contraseña separadas por dos puntos y luego codificar la cadena en base64.

Ejemplo:

Si nuestro usuario fuera “api” y nuestra contraseña fuera “api”, nuestra concatenación será:

api:api

Al codificar en base64 obtendremos la cadena:

YXBpOmFwaQ==

Ahora utilizaremos el verbo HTTP POST con la URI del recurso de autenticación, en el header debes incorporar una variable y el valor de la cadena concatenada, ejemplo:

Authorization:Basic YXBpOmFwaQ==

Cuando ejecutemos el POST al endpoint de autenticación obtendremos un listado de los sistemas asociados al usuario y un token de acceso con el que podrás ejecutar todos los demás recursos.

URL del recurso

https://api.nubox.com/nubox.api/autenticar

Información del recurso

Formato de respuesta	JSON
¿Requiere autenticación?	SI
¿Requiere token?	NO
¿Requiere Partner key?	NO

Parámetros

Nombre	Descripción	Tipo del parámetro	Tipo del dato
Authorization	Cadena en base64 que representa un usuario y contraseña	Header	String

Ejemplos de Request

Ejemplo Response

Response Body

Response Header

Nombre	Valor
Date	Tue, 28 Apr 2020 23:57:37 GMT
Content-Type	application/json; charset=utf-8
Content-Length	935
Connection	keep-alive
Cache-Control	no-cache
Pragma	no-cache
Expires	-1
Access-Control-Expose-Headers	Token,TokenExpiry
Token	86c908f8-1b27-45b2-b62d-7d5d5d5ab142

Token de Acceso

El token te permitirá autenticar tus llamadas con esto te comunicaras de forma segura, debes tener en cuenta que el ciclo de vida del token es de 15 minutos de inactividad, es decir si no generas alguna petición en 15 minutos el token expirará, por lo cual sugerimos tener una rutina de autenticación en caso de expiración.