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.

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:

SHQzNzk4ODlSZGQ6Q2wzNFNkclR5

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 SHQzNzk4ODlSZGQ6Q2wzNFNkclR5

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

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
Server Microsoft-IIS/8.5
X-StackifyID V2|0770a7e9-3352-48cd-a8fe-d3bf215c2aff|C77694|CD20
Access-Control-Expose-Headers Token,TokenExpiry
Token 86c908f8-1b27-45b2-b62d-7d5d5d5ab142
X-AspNet-Version
4.0.30319
X-Powered-By ASP.NET

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 60 minutos de inactividad, es decir si no generas alguna petición en 60 minutos el token expirará, por lo cual sugerimos tener una rutina de autenticación en caso de expiración.

Pruebas

Probar en Swagger