En esta guía te enseñaremos cómo activar la API de Clopri para que puedas integrar aplicaciones externas con la plataforma.
Ten en cuenta que esta guía está dirigida a desarrolladores y requiere conocimientos técnicos básicos.
¿Qué es una API?
Una API (Interfaz de Programación de Aplicaciones) es un conjunto de reglas que permite que diferentes sistemas o aplicaciones se comuniquen entre sí.
En términos simples, una API funciona como un intermediario: recibe una solicitud, la procesa y devuelve una respuesta.
Por ejemplo, cuando una aplicación externa necesita consultar información en Clopri, lo hace a través de la API. La API recibe la petición, valida los datos y responde con la información solicitada de forma segura y estructurada.
Gracias a las APIs, es posible automatizar procesos, sincronizar datos entre sistemas y crear integraciones personalizadas.
Cómo instalar la API de Clopri
Para instalar la API de Clopri, primero debes dirigirte al apartado “Apps” dentro del menú principal de Clopri.
Luego, en la tienda de aplicaciones, busca “API Connect”.
Haz clic en el botón que dice “Obtener” o “Instalar App”.
Una vez instalada, regresa al apartado donde se encuentran las aplicaciones. Allí encontrarás la nueva app llamada “API Connect”.
Haz clic para ingresar a la aplicación.
Dentro encontrarás el panel principal, donde podrás crear los tokens de acceso y consultar la documentación de los endpoints disponibles.
Las APIs necesitan un access token para poder funcionar. Este es un término importante que debemos conocer.
¿Qué es un token o access token?
Un access token es una clave de acceso que permite a una aplicación autenticarse y comunicarse con la API de forma segura.
En otras palabras, es como una contraseña digital que autoriza a un sistema externo a realizar solicitudes a la plataforma.
Cada vez que una aplicación envía una petición a la API, debe incluir su access token. Si el token es válido, la API procesará la solicitud; si no lo es, la petición será rechazada.
Esto garantiza que solo aplicaciones autorizadas puedan acceder a la información.
Para crear un token, haz clic en el botón que dice “Nuevo token”.
Luego, en la ventana que aparece, ingresa el nombre del token o de la aplicación que se conectará a Clopri. Después, configura los permisos según tus necesidades.
Ten en cuenta cómo se utilizará este token, ya que puede ser peligroso compartirlo o asignarle permisos innecesarios.
Por seguridad, otorga únicamente los permisos estrictamente necesarios y evita exponer el token en lugares públicos o repositorios de código.
Guarda el token en un lugar seguro y utilízalo para realizar consultas a los distintos endpoints disponibles en API Connect.
Recuerda que este token es confidencial y no debe compartirse con terceros.
Una vez que tengas el token, solo queda revisar y comprender la documentación y los distintos endpoints disponibles.
Puedes encontrar la documentación en el menú de la aplicación, en la opción “Documentación”.
