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 6 aplicaciones (Producción y Pruebas).
Cada aplicación cuenta con su propio par de API Key y Clave Secreta.

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:

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:

2. 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: