Token de autenticación

El token de autenticación te permite validar tu identidad y tener acceso a nuestras APIs. El token de autenticación debe ser ingresado en el campo x-api-key o authorization dependiendo de la API que estés consumiendo.

En este tutorial aprenderás a generar tu token de autenticación con base64. Para ello necesitas primero obtener tu API key y clave secreta.

Este es un ejemplo de cómo se verá tu token de autenticación al finalizar este tutorial:

Basic YWJhNWJkNjQtOTYwOC00N2E4LWIwMzUtNWU2NDkzOTBjZTViOmY2NmI0MzVkLTFmYTEtNDk5NC0wMmI2LTBiYTYzMmJhMThiZA==


En las siguientes secciones describimos los pasos para la obtención de la API key y la clave secreta y después te ofrecemos tres métodos para generar tu token de autenticación.


1. Obtén tu API key y clave secreta


🚧

Importante

Puedes crear un máximo de 2 aplicaciones, cada una con su par de API key y clave secreta.

Si necesitas generar una nueva aplicación, deberás eliminar una de las aplicaciones existentes para poder hacerlo.


En esta sección te mostraremos cómo crear un nuevo set de API key y clave secreta.

  1. Ingresa al Panel de Desarrollador dentro del Panel de Clip.

  2. Una vez en el panel de desarrollador tendrás acceso a la sección de credenciales, en donde podrás crear tus credenciales tanto productivas como de prueba:

  3. Selecciona "Crear credencial"

  4. Asígnale un nombre a esas credenciales y dale click en "Crear":

  5. Copia y guarda tu API key y clave secreta en algún lugar seguro:


🚧

Importante

Por motivos de seguridad, la clave secreta sólo se puede consultar la primera vez que la obtienes. Cópiala y guárdala en un lugar seguro. Si pierdes acceso a tu clave secreta, deberás generar una nueva.

Si necesitas obtener una nueva API key, deberás eliminar la actual de la lista y crear una nueva.


2. Crea un token de autenticación con codificación Base64

Después de obtener tu API key y clave secreta podrás generar tu token de autenticación. A continuación te mostraremos tres formas de generar tu token.


2.1 Generador de token de autenticación

Ingresa tu API key y clave secreta en este formulario:

Clip Auth Token Generator







2.2 Línea de comando

  1. Copia y pega la siguiente instrucción en una terminal:
echo -n Tu_API_Key:Tu_Clave_Secreta | base64

Este es un ejemplo de cómo se verá ejecutado en una terminal:

1454
  1. Copia la clave generada y agrega el prefijo 'Basic', seguido de un espacio como se muestra a continuación. Este es tu token de autenticación, guárdalo en un lugar seguro.
Basic YWJhNWJkNjQtOTYwOC00N2E4LWIwMzUtNWU2NDkzOTBjZTViOmY2NmI0MzVkLTFmYTEtNDk5NC0wMmI2LTBiYTYzMmJhMThiZA==

2.3 Consola del navegador

Para crear tu token de autenticación desde la consola de tu navegador, utiliza el siguiente script:

let api_key= "Tu_API_Key";
let api_secret= "Tu_Clave_secreta";
let b64 = btoa(unescape(encodeURIComponent(api_key + ":" + api_secret)));
console.log(`Basic ${b64}`)

El cual responde con tu token de autenticación

Basic YWJhNWJkNjQtOTYwOC00N2E4LWIwMzUtNWU2NDkzOTBjZTViOmY2NmI0MzVkLTFmYTEtNDk5NC0wMmI2LTBiYTYzMmJhMThiZA==

A continuación te mostramos un ejemplo de este método:

1104