¿Qué son las API y cómo funcionan?
¿Te ha pasado que descargas una aplicación en tu celular o entras en una página web desde tu computador, y te da la opción de iniciar sesión con Facebook? Eso es posible gracias a una API.
Este término es muy utilizado en el mundo de la tecnología, pues es parte fundamental en el funcionamiento de las aplicaciones. API es la abreviatura en inglés de Application Programming Interfaces, lo que se traduce al español como interfaz de programación de aplicaciones.
Existe mucho desconocimiento respecto a qué son las API, y esto se debe principalmente a que no son una estructura visible en una aplicación o página web, sino que es algo interno que solamente los programadores pueden ver.
En este artículo de Made of Clay te vamos a explicar todo lo que necesitas saber.
¿Qué es una API?
Una API es un conjunto de definiciones que permiten la integración entre dos aplicaciones con el objetivo de cumplir una o varias funciones.
Las API llegaron para facilitarles el trabajo a los desarrolladores web, pues no tienen que ocupar tiempo y dinero en crear nuevas aplicaciones o funcionalidades para poner en marcha un proyecto.
Un buen ejemplo de esto se da en los ecommerce. Supongamos que tienes una tienda online de venta de ropa en la que tus clientes tienen la opción de pagar a través de plataformas como PayPal o cualquier otra aplicación de pago a través de internet. ¿Cómo crees que se logra esta integración? Sí, a través de una API.
Otro ejemplo de API es cuando abres la aplicación del transporte público de tu ciudad, y te permite ver el recorrido a través de Google Maps.
Como ves, las API tienen múltiples usos y son de gran utilidad para facilitarle la vida no solamente a los desarrolladores, sino también a los usuarios de aplicaciones.
Tipos de API
De manera general, podemos identificar 3 tipos de API: privada, pública y de socio. Te contamos en qué consiste cada una.
API privada: se utilizan dentro de las empresas únicamente para conectar datos y sistemas propios de un negocio. En Clay tenemos dos de este tipo, las cuales te explicaremos más adelante.
API pública: estas son abiertas para desarrolladores que no trabajan en la empresa. En Clay también tenemos algunas API’s de este tipo, pero eso también te lo contaremos más adelante.
API de socio: las API de socio están disponibles para desarrolladores externos autorizados por la empresa para fines específicos.
Protocolos de las API
Las API trabajan con diferentes protocolos que permiten estandarizar el intercambio de datos. Te explicamos cómo funcionan estos protocolos.
SOAP: significa simple object access protocol. Este protocolo permite crear servicios web sin estado en un formato XML.
Rest: es la abreviatura de representational state transfer. Es una alternativa al SOAP porque “facilita la disponibilidad de datos como recursos”, consigna el sitio web Sydle.
API’s de Clay
Como empresa dedicada a la tecnología financiera (fintech), también usamos API a través de las cuales nuestros usuarios pueden realizar diferentes integraciones. Concretamente, tenemos dos, cada una con objetivos distintos. La primera es https://api.clay.cl/docs/, para quienes usan la plataforma para conciliar, cobrar o hacer contabilidad.
Con esta API puedes obtener movimientos bancarios, documentos tributarios y estados financieros, además de la conciliación bancaria que se expresa en un match por registro.
Luego tenemos la API de OpenBanking (https://openbanking.clay.cl/) que la usan quienes solo quieren obtener cartolas definitivas (una cartola es definitiva al día siguiente sobre el día anterior).
API Clay
La API fue creada para que puedas usar tu información en Clay e integrarla con otros sistemas. Esta ayuda también te…
Con nuestra API rest podrás conectarte con 12 bancos diferentes en Chile, tener acceso a las cartolas diarias, de transferencias y de proveedores, además de los saldos contables. Con pocas líneas de código puedes implementar la API Bancaria de Clay en una tarde.
¿Cómo usan los clientes de Clay la API bancaria?
ERP’s que se llevan información a sus clientes.
Conciliación en Clay y luego llevarse esa información a su propio ERP.
BPO’s que externalizan el proceso de conciliación.
Empresas que externalizan la administración financiera y que buscan mejorar sus procesos internos.
Uno de nuestros clientes, Smart CFO también las usa para “desarrollar una reportabilidad a la medida, con alta eficiencia en tiempo a nivel de generación de los reportes. Por otro lado, nos han permitido un control específico sobre nuestra operación, y por ende mayores tiempos de respuesta”.
API Bancaria - Clay :: Gestión Financiera Inteligente
API Bancaria La forma más fácil para las empresas de conectarse con su información bancaria. DOCUMENTACIÓN Más Info…
¿Qué es un token?
William Mougayar, autor del libro “The Business Blockchain” (el negocio del blockchain) define el token como “una unidad de valor que una organización crea para gobernar su modelo de negocio y dar más poder a sus usuarios para interactuar con sus productos, al tiempo que facilita la distribución y reparto de beneficios entre todos sus accionistas”.
En Clay, el token sirve como un método de autenticación para nuestras API, y la creación de estas “unidades de valor”, como lo define Mougayar, está solo habilitada para los usuarios administradores o dueños de la cuenta de tu empresa.
Los token son por usuario. Si quieres tener un reporte de varias empresas, solo necesitarás un token. Dentro de la API deberás identificar con qué empresas quieres trabajar.
Para obtener un token en nuestra plataforma, debes ir a Ajustes Generales, Perfil y luego en la sección “Tokens para API’s” podrás crear uno nuevo.
Recuerda que eliminando el token, ningún sistema que lo use tendrá acceso o podrá sacar o modificar datos. Tendrás que hacer otro y volver a conectar los sistemas.
Cómo crear un token para la API
Los token son métodos de autenticación de la API de Clay. Aquí puedes aprender sobre qué es una API. La creación de…
API’s públicas de Clay
En Clay también tenemos 6 API’s públicas. Son las siguientes:
Obligaciones
Empresas
Cuentas bancarias
Clientes y proveedores
Contabilidad
Conexiones
Esperamos que este artículo te haya servido para aclarar todas tus dudas respecto a las API’s. De todos modos, recuerda que en nuestra sección API Bancaria encontrarás mayor información. Asimismo, te invitamos a visitar el Centro de Ayuda y escribir la palabra “API” en el buscador para obtener mayor detalle.
