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

    Hubspot - nubox (5)

    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

    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.

    Pruebas

    Probar en Swagger