# Que é unha API e por que debería importarche aínda que non sexas técnico Source: https://baqueiro.es/gl/codigo-que-trabaja-por-ti/que-e-unha-api-e-por-que-che-importa/ Published: 2025-03-26T08:14:00+00:00 Updated: 2025-03-26T08:14:00+00:00 Author: Baqueiro Desarrollo Web Language: gl-ES Usage: Atribución requirida: permítese a cita cunha ligazón visible de volta --- Se estiveches nalgunha reunión técnica nos últimos anos, seguramente escoitases a palabra API. Quizais varias veces. Quizais sen que ninguén parase a explicala. É un deses termos que os equipos técnicos usan con total naturalidade, dando por feito que todo o mundo sabe de que falan. E moitas veces, ao outro lado da mesa, hai alguén que asente sen ter claro que significa, por non interromper. Este artigo é para esa persoa. E para calquera que tome decisións sobre tecnoloxía na súa empresa e queira entender que quere dicir o seu equipo técnico cando propón “conectar isto vía API”. **TL;DR** - Unha API é unha canle de comunicación entre 2 sistemas que lles permite intercambiar información de forma automática e estruturada. - Case todos os servizos dixitais que usas teñen unha: o teu CRM, a túa tenda en liña, a túa ferramenta de email, Google Maps ou Stripe. - Entender que é unha API axúdache a avaliar mellor as ferramentas que escolles, as integracións que contratas e as dependencias que asumes. ## A explicación sen xerga Imaxina que traballas nunha oficina e necesitas uns datos do departamento de contabilidade. Podes ir ti mesmo, remexer nos seus arquivadores e sacar o que buscas. Ou podes chamar, pedir exactamente o que necesitas e agardar a que contabilidade cho envíe no formato que acordastes. A segunda opción é máis ordenada, máis segura e máis eficiente. Contabilidade non ten que abrirche todos os seus arquivos: só responde a peticións concretas, no formato pactado, coa información que decide compartir. Unha API funciona dun xeito moi parecido, pero entre sistemas informáticos. É a canle pola que un sistema lle di a outro “dáme a información X” ou “fai a acción Y”, e o outro responde de forma estruturada. Ninguén ten que intervir a man, ningún sistema ten acceso completo ao outro e as regras sobre que se pode pedir e como están claras desde o principio. ## Por que está en todas partes aínda que non a vexas As API son a infraestrutura invisible de boa parte do que funciona hoxe en internet. Cando a túa tenda en liña confirma un pedido e o cliente recibe no momento un correo de confirmación, hai unha API polo medio. Cando escribes un enderezo nun formulario e aparece un mapa de Google coa localización, hai unha API polo medio. Cando a túa ferramenta de email márketing avisa o teu CRM de que un contacto abriu a última campaña, tamén hai unha API polo medio. Nada diso é maxia: son 2 sistemas que falan entre si a través dunha API, sen que ninguén teña que copiar nin pegar nada. ## 3 situacións nas que as API marcan a diferenza ### Cando queres que 2 ferramentas compartan datos É o uso máis habitual. Tes un CRM e unha ferramenta de email márketing, e queres que cada contacto novo que entra no CRM apareza automaticamente na lista correcta da ferramenta de email. Sen exportar, sen importar e sen depender de que alguén se lembre de sincronizalo. Se ambas as ferramentas teñen API (e a maioría das ferramentas actuais téñena), esa sincronización pódese automatizar. Os datos flúen sós, coas regras que ti definas. O mesmo serve para os informes dun ERP, como explicamos en [como automatizar o reporting do teu ERP sen cambiar de sistema](https://baqueiro.es/gl/codigo-que-trabaja-por-ti/automatizar-informes-erp-sen-cambiar-sistema/). Se unha das 2 non ten API, a sincronización ten que facerse doutra maneira: exportacións periódicas, procesos manuais ou solucións técnicas máis complexas que imitan o que unha API faría de forma nativa. ### Cando queres usar datos ou funcións dun servizo externo na túa web Moitos servizos ofrecen as súas funcións a través dunha API para que outras aplicacións poidan usalas. Stripe ten unha API para procesar pagamentos. Google Maps, unha para amosar mapas e calcular rutas. Twilio, unha para enviar SMS. OpenAI, unha para usar os seus modelos de intelixencia artificial. Cando a túa web amosa un mapa, cobra un pagamento ou envía unha notificación, o máis probable é que estea a usar a API dalgún destes servizos en lugar de ter construído esa función desde cero. Para que desenvolver o teu propio sistema de pagamentos se Stripe xa o ten resolto? ### Cando queres que o teu propio sistema sexa accesible desde outros sitios Se a túa empresa ten datos ou funcións que quere compartir con partners, clientes ou aplicacións propias, pode construír a súa propia API. Iso converte o teu sistema nunha plataforma que outros poden integrar, en lugar dunha ferramenta pechada que só funciona nun contexto. Un exemplo sinxelo: un distribuidor que expón o seu catálogo e o seu stock mediante unha API permite que as tendas dos seus clientes amosen a dispoñibilidade real sen chamadas nin follas de cálculo semanais. É o mesmo principio sobre o que se constrúen os ecosistemas dixitais máis sólidos: unha fonte de datos central á que acceden varias aplicacións e canles. ## O que deberías preguntar cando alguén menciona unha API Con este contexto, as conversas técnicas sobre API deixan de ser opacas. Hai 4 preguntas que che permiten participar nelas con criterio, aínda que non sexas o técnico do equipo. **Que información se vai intercambiar?** As API intercambian datos concretos. Saber cales che permite valorar se a integración ten sentido e se o que vai circular é o que realmente necesitas. **Quen ten acceso a que?** Unha API ben deseñada controla que información comparte e con quen. Preguntar polos permisos e polo modelo de seguridade é perfectamente razoable. **Que pasa se a API do provedor cambia ou desaparece?** É unha dependencia real. Se o teu proceso depende da API dun terceiro e ese terceiro cambia as súas condicións, sobe o prezo ou pecha o servizo, o teu proceso resíntese. Non é motivo para non usar API, pero si para telo en conta ao deseñar procesos críticos. **Hai límites no número de chamadas?** A maioría das API teñen límites de uso (chamadas por minuto, por día ou por volume de datos) que poden afectar ao rendemento cando o sistema medra. Coñecelos antes de construír evita sorpresas o día en que o volume se multiplica. ## Como afectan as API ás decisións que tomas sobre ferramentas Entender que é unha API cambia a forma de avaliar o software que adoptas. Antes de comprometerte con calquera ferramenta nova, paga a pena facer unha pregunta: ten API? Unha ferramenta sen API vive no seu propio mundo. Os datos que entran nela non saen con facilidade, non se pode integrar con outras sen procesos manuais e, se no futuro queres conectala con algo, as opcións serán limitadas e caras. Unha ferramenta cunha API ben documentada pode formar parte dun ecosistema. Os seus datos poden ir onde os necesites, pode recibir información doutros sistemas, pódese automatizar e pode medrar coa túa empresa en lugar de converterse nun silo. O que cambia cando iso ocorre contámolo en [o que gaña unha empresa cando os seus sistemas deixan de funcionar en silos](https://baqueiro.es/gl/automatizacion/silos-datos-empresa-conectar-sistemas-gl/). Non é o único criterio para escoller unha ferramenta, pero é un que poucas veces se ten en conta e que pesa moito na flexibilidade tecnolóxica a longo prazo. ## Lista de comprobación: preguntas sobre API antes de adoptar calquera ferramenta - A ferramenta ten unha API pública e ben documentada? - Que datos expón a API e cales quedan fóra do seu alcance? - Hai límites de uso que poidan afectar ao rendemento co volume previsto? - A API está incluída no plan que vas contratar ou é un extra de pagamento? - Hai webhooks dispoñibles para recibir avisos en tempo real cando algo cambia? - Que pasa cos datos se decides deixar de usar a ferramenta? ## Preguntas frecuentes ### Cal é a diferenza entre unha API e unha integración? Unha API é a tecnoloxía: a canle de comunicación que un sistema ofrece para que outros poidan conectarse a el. Unha integración é a implementación concreta desa conexión: o código ou a configuración que fai que 2 sistemas concretos falen entre si a través das súas API. Dito doutro xeito: a API é a porta, e a integración é o camiño que constrúes para chegar a ela e usala. ### Necesito coñecementos técnicos para xestionar integracións entre ferramentas? Depende do tipo de integración. Plataformas como Zapier ou Make permiten conectar ferramentas que teñen API sen escribir código, con interfaces visuais que calquera persoa con algo de práctica pode configurar. Iso si, convén facelo con orde, como explicamos en [como conectar a túa web con Make ou Zapier sen crear unha bomba de reloxería](https://baqueiro.es/gl/automatizacion/conectar-web-make-zapier-sen-problemas/). Para integracións máis complexas (con lóxica de negocio propia, transformacións de datos ou volumes altos) si fai falta desenvolvemento. Pero entender que é unha API e que queres conseguir non require coñecementos técnicos, e é o que che permite falar con criterio con quen si os ten. ### É seguro compartir datos a través dunha API? Si, cando a API está ben deseñada e configurada. As API actuais usan mecanismos de autenticación para que só os sistemas autorizados poidan acceder aos datos, e permiten definir exactamente que información se comparte e con quen. Os problemas de seguridade con API adoitan ter a súa orixe en configuracións incorrectas ou en API mal deseñadas, non na tecnoloxía en si. En Baqueiro deseñamos e implementamos integracións entre sistemas mediante API, e explicámosche o que facemos nunha linguaxe que non require formación técnica. Se tes ferramentas que non falan entre si e queres saber que implicaría conectalas, [cóntanolo](https://baqueiro.es/gl/contacto/) e vémolo xuntos.