Token de Autenticación

Sigue estos pasos para obtener tu token de autenticación:

  1. Ingresa al panel de desarrolladores y Genera tu API Key y Clave Secreta.
  2. Crea tu token de autenticación con codificación en Base64

Este es un ejemplo de cómo se vería tu token de autenticación final:

Basic YWJhNWJkNjQtOTYwOC00N2E4LWIwMzUtNWU2NDkzOTBjZTViOmY2NmI0MzVkLTFmYTEtNDk5NC0wMmI2LTBiYTYzMmJhMThiZA==

🚧

Importante

Este token lo deberás usar en el campo x-api-key o authorization dependiendo de la API que estés consumiendo. Consulta la documentación de la API para conocer más detalles.

Para conocer el proceso detallado de creación del token de autenticación consulta las secciones a continuación.

1. Genera una 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.
300

Panel de Desarrollador habilitado al final del menú

  1. Dirígete a la sección de Aplicaciones, en el menú del lado izquierdo.
500

Menú de aplicaciones

  1. Genera un nuevo set de API Key y Clave Secreta con el botón de Crear aplicación.
553

Ventana de Aplicaciones para generar API Keys

🚧

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.

  1. Introduce un nombre para la aplicación.
553

Ventana para asignar un nombre a una nueva aplicación

📘

Nota

El nombre sólo puede contener un máximo 30 caracteres y números. (No se permiten acentos ni la letra ñ).

  1. Copia y guarda tu API Key y Clave secreta en algún lugar seguro.
467

Visualización de la API Key y Clave secreta al haberlas generado

🚧

Importante

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

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

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

Después de generar un nuevo set de API key y Clave secreta, necesitas crear un token de autenticación. Las API de Clip utilizan el método de autenticación Basic.

En esta sección te mostraremos dos formas de crear tu token: mediante la línea de comando y la consola del navegador:

2.1 Línea de comando

  1. Utiliza el siguiente comando para crear el token de autenticación desde la línea de comando de una terminal:
echo -n Tu_API_Key:Tu_Clave_Secreta | base64

🚧

Importante

Asegúrate de reemplazar Tu_API_Key y Tu_Clave_Secreta por tu par de llaves generados desde el Portal de Desarrolladores de Clip.

Así se vería el comando ejecutado en una terminal:

1454

Comando para generar token de autenticación en terminal

  1. Copia la clave generada y agrega el prefijo 'Basic', seguido de un espacio. Este es tu token de autenticación, te mostramos un ejemplo de cómo quedaría:
Basic YWJhNWJkNjQtOTYwOC00N2E4LWIwMzUtNWU2NDkzOTBjZTViOmY2NmI0MzVkLTFmYTEtNDk5NC0wMmI2LTBiYTYzMmJhMThiZA==
  1. Utiliza tu token de autenticación en el encabezado o "header" de autenticación especificado en la referencia técnica de cada endpoint.

2.2 Consola del navegador

  1. 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 resultado será tu token de autenticación y debería verse como el siguiente ejemplo

Basic YWJhNWJkNjQtOTYwOC00N2E4LWIwMzUtNWU2NDkzOTBjZTViOmY2NmI0MzVkLTFmYTEtNDk5NC0wMmI2LTBiYTYzMmJhMThiZA==

🚧

Importante

Asegúrate de reemplazar Tu_API_Key y Tu_Clave_Secreta por tu par de llaves generados desde el Portal de Desarrolladores de Clip.

La siguiente imagen te muestra un ejemplo de uso de este método:

1104

Ejemplo de uso del script en la consola del navegador.

  1. Utiliza tu token de autenticación en el encabezado o "header" de autenticación especificado en la referencia técnica de cada endpoint.

🚧

Importante

Este token lo deberás usar en el campo x-api-key o authorization dependiendo de la API que estés consumiendo. Consulta la documentación de la API para conocer más detalles.