Sigue estos pasos para obtener tu token de autenticación:
- Ingresa al panel de desarrolladores y Genera tu API Key y Clave Secreta.
- 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
- Ingresa al Panel de Desarrollador dentro del Panel de Clip.
Panel de Desarrollador habilitado al final del menú
- Dirígete a la sección de Aplicaciones, en el menú del lado izquierdo.
Menú de aplicaciones
- Genera un nuevo set de API Key y Clave Secreta con el botón de Crear aplicación.
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.
- Introduce un nombre para la aplicación.
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 ñ).
- Copia y guarda tu API Key y Clave secreta en algún lugar seguro.
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
- 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:
Comando para generar token de autenticación en terminal
- 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==
- 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
- 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:
Ejemplo de uso del script en la consola del navegador.
- 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.