Qué es una API y para qué sirve en una empresa
Qué es una API, en una frase: el canal estándar por el que dos programas se piden datos o acciones sin que nadie copie nada a mano. Esta guía explica cómo funciona, qué partes tiene, qué tipos existen, qué ventajas y límites aporta, qué seguridad y qué normas afectan a una API en España y en la UE, y cuándo compensa construir una propia.
La respuesta corta
API significa application programming interface, interfaz de programación de aplicaciones. Un programa (el cliente) envía una petición a otro (el servidor) siguiendo unas reglas publicadas: qué dirección usar, qué datos enviar, qué permisos necesita y qué respuesta recibirá. El usuario no ve la API; ve el resultado. Cuando la tienda online muestra el stock real del almacén, cuando el banco entrega los movimientos al programa de contabilidad o cuando el CRM crea un cliente en el ERP, detrás hay una API.
Para una empresa, la API es lo que convierte programas aislados en un sistema. Sin ella, los datos viajan en hojas de cálculo, exportaciones nocturnas y correos electrónicos con adjuntos, y cada copia es una oportunidad de error.
Cómo funciona una API
El ejemplo más habitual en una pyme es un pedido que entra por la tienda online y debe acabar en el ERP:
- El cliente confirma la compra en la tienda.
- La tienda envía una petición a la API del ERP con los datos del pedido, identificándose con una credencial.
- La API comprueba que la credencial es válida y que tiene permiso para crear pedidos.
- Valida los datos: que el artículo existe, que el cliente tiene NIF correcto, que las cantidades son números.
- El ERP crea el pedido y la API devuelve una respuesta con el número asignado, o un error explicado si algo falla.
- La tienda guarda ese número y, si la petición falló, la reintenta o avisa a una persona.
Ese intercambio dura milisegundos y se repite miles de veces al día. Lo importante para el negocio no es la técnica, sino qué ocurre cuando algo falla: si el pedido se pierde, se duplica o queda registrado con un aviso. Por eso una buena integración se diseña tanto para el caso normal como para el error.
Las partes de una API
| Parte | Qué es | Ejemplo |
|---|---|---|
| Endpoint | La dirección a la que se envía cada petición | /pedidos, /clientes/123 |
| Método | La acción que se pide sobre el recurso | GET para leer, POST para crear |
| Petición y respuesta | Los datos que se envían y los que vuelven, con un formato acordado | JSON con el pedido y su número |
| Autenticación | Cómo demuestra el cliente quién es y qué puede hacer | OAuth 2.0, claves de API, certificados |
| Códigos de estado | El resultado de la petición en un número estándar | 200 correcto, 401 sin permiso, 404 no existe |
| Límites de uso | Cuántas peticiones se aceptan por minuto o por día | Protegen el servidor y reparten la capacidad |
| Documentación | El contrato publicado que describe todo lo anterior | Una especificación OpenAPI |
La documentación suele escribirse con la especificación OpenAPI, cuya última versión publicada es la 3.2.1, de 10 de septiembre de 2026 (consultado el 13 de noviembre de 2026). Un único archivo describe cada endpoint, sus campos y sus errores, y de él se generan documentación legible y pruebas automáticas.
Tipos de API
- API REST: el estilo más común en la web. Recursos con dirección propia, métodos HTTP y respuestas en JSON. Es lo que ofrecen la mayoría de ERP, CRM y tiendas online del mercado, como Holded, Odoo, Shopify o WooCommerce.
- Webhooks: la API al revés. En lugar de preguntar cada pocos minutos si hay pedidos nuevos, el sistema origen avisa en cuanto ocurre algo. Ahorra peticiones y reduce el retraso.
- GraphQL: el cliente pide exactamente los campos que necesita en una sola consulta. Útil en apps móviles y paneles con muchas vistas distintas.
- SOAP y servicios web XML: más antiguos y formales, todavía presentes en banca, administración pública y algunos ERP veteranos.
- Por alcance: privadas (solo para sus propios sistemas), de socios (para clientes o proveedores concretos, con contrato) y públicas (abiertas a terceros con registro).
Para qué sirve una API en el día a día
- Sincronizar stock, precios y pedidos entre la tienda online y el ERP.
- Pasar los clientes ganados en el CRM a facturación sin volver a teclearlos.
- Recibir los movimientos bancarios y conciliar cobros.
- Enviar los registros de facturación a la Agencia Tributaria desde el programa de facturación, como prevé el sistema VeriFactu (lo explicamos en nuestra guía de VeriFactu).
- Calcular portes y generar etiquetas con la agencia de transporte.
- Dar a sus clientes un portal o una app que consulte pedidos y facturas en tiempo real.
- Usar modelos de inteligencia artificial para clasificar correos o leer documentos.
Ventajas y límites de trabajar con APIs
| Ventajas | Límites |
|---|---|
| Cada dato se introduce una vez y llega a todos los sistemas | Depende de que el otro programa ofrezca una API y de lo que permita hacer |
| Menos errores de copia y menos trabajo administrativo | Los proveedores cambian versiones y retiran funciones; hay que mantener la integración |
| Datos al momento, no al día siguiente | Una integración sin vigilancia puede fallar en silencio |
| Permite cambiar una pieza sin rehacer todo el sistema | Cada conexión abierta es una superficie que hay que proteger |
| Base para portales, apps y automatización | Los límites de uso del proveedor pueden frenar volúmenes altos |
Seguridad básica de una API
La mayoría de los incidentes en APIs no vienen de ataques sofisticados, sino de permisos mal comprobados. La lista OWASP API Security Top 10 de 2023 sitúa en primer lugar la autorización rota a nivel de objeto: una API que entrega el pedido 124 a quien solo debería ver el 123 (consultado el 13 de noviembre de 2026). Las prácticas mínimas:
- Comprobar en cada petición que quien pregunta tiene derecho a ese registro concreto, no solo a la API en general.
- Usar OAuth 2.0 según el RFC 9700, buenas prácticas de seguridad de OAuth 2.0, que recomienda PKCE en el flujo de código de autorización (consultado el 13 de noviembre de 2026).
- Credenciales distintas por integración, con el mínimo permiso necesario y fecha de renovación.
- Cifrado en tránsito (HTTPS) siempre, registros de acceso y alertas ante picos anómalos.
Lo que exige la ley a una API en España y en la UE
- Protección de datos. Si la API mueve datos personales de clientes o empleados, el artículo 32 del RGPD exige medidas técnicas y organizativas apropiadas al riesgo, entre ellas el cifrado y la capacidad de garantizar la confidencialidad y la integridad; y si un proveedor trata esos datos por cuenta de su empresa, el artículo 28 exige un contrato de encargo (consultado el 13 de noviembre de 2026).
- Portabilidad entre servicios en la nube. El Reglamento (UE) 2023/2854 de Datos, aplicable desde el 12 de septiembre de 2025, obliga en su artículo 23 a los proveedores de servicios de tratamiento de datos a eliminar los obstáculos para que el cliente cambie de proveedor (consultado el 13 de noviembre de 2026). Una API documentada es la forma práctica de sacar sus datos.
- Facturación. Los sistemas que emiten facturas en España deben adaptarse a VeriFactu en los plazos de la Agencia Tributaria; la integración con el ERP o la tienda tiene que respetar esos registros.
Cuándo compensa una API o una integración propia
Si sus programas ya se conectan con un conector estándar o con plataformas como Zapier, Make o n8n, y los volúmenes son moderados, no hace falta más. Una integración a medida, o una API propia, compensa cuando:
- El conector estándar no cubre su caso (tarifas por cliente, unidades de medida, lotes, varios almacenes).
- Los errores se descubren días después y nadie sabe qué pedido falló.
- Clientes o socios le piden acceso a pedidos, stock o facturas de forma estable.
- Quiere una app o un portal sobre sus propios datos, sin depender de exportaciones.
- Uno de sus programas no tiene API y la información se rescata a mano.
En DT Nova diseñamos integraciones con precio cerrado para el alcance acordado por escrito, alojamiento en la UE como estándar y el código fuente propiedad de su empresa desde el primer día. Usted ve la integración funcionando antes de ponerla en producción. Vea nuestro servicio de integración de APIs, la lógica de un presupuesto en cuánto cuesta un software a medida y la comparación software a medida o estándar. Si la API es para una aplicación web, le servirá también la guía de desarrollo de aplicaciones web.
Preguntas frecuentes
¿Qué es una API en palabras sencillas?
Es una puerta controlada por la que un programa pide datos o acciones a otro. La tienda online pregunta al ERP cuánto stock queda, el ERP responde con un dato estructurado y nadie tiene que copiar nada a mano. La API define qué se puede pedir, cómo y quién tiene permiso.
¿Qué significa API?
API son las siglas en inglés de application programming interface, en español interfaz de programación de aplicaciones. Es el contrato técnico que un sistema publica para que otros sistemas trabajen con él.
¿Qué es una API REST?
Es el estilo de API más extendido en la web. Cada recurso (un cliente, un pedido, una factura) tiene una dirección, y se consulta o modifica con los métodos de HTTP: GET para leer, POST para crear, PUT o PATCH para cambiar y DELETE para borrar. Las respuestas suelen ir en formato JSON.
¿Qué es una API key?
Es una clave que identifica al programa que hace la petición. Sirve para saber quién consume la API y para limitar su uso, pero por sí sola no es un control de acceso fuerte: para datos de clientes o de empleados conviene OAuth 2.0 con permisos por alcance y claves que se renuevan.
¿Qué es una API en IA?
Los modelos de inteligencia artificial también se usan a través de APIs: su aplicación envía un texto o un documento y recibe la respuesta del modelo. Las mismas reglas aplican: qué datos salen de su empresa, dónde se procesan y qué contrato de encargo del tratamiento existe con el proveedor.
¿Toda empresa necesita una API propia?
No. Muchas pymes solo necesitan conectar programas que ya tienen API. Una API propia tiene sentido cuando clientes, socios o sus propias apps necesitan acceder a sus datos de forma estable, o cuando quiere dejar de depender de exportaciones manuales.
Solicite un presupuesto por escrito
Describa en unas líneas lo que necesita. En un día laborable recibe un presupuesto por escrito: alcance, plazos y precio cerrado o estimación de horas. La solicitud no le compromete a nada.