Punto de partida
Cuando la lógica ya no debería vivir dispersa
Casi ningún producto empieza necesitando un backend propio. La necesidad aparece cuando la segunda aplicación quiere usar las mismas reglas y hay que decidir dónde viven de verdad.
- situación 01
Una sola aplicación
Interfaz, reglas y datos conviven en el mismo proyecto. Funciona, es rápido de construir y durante un tiempo es la decisión correcta.
- situación 02
Aparece un segundo consumidor
Una app, un portal o un nuevo frontend necesitan las mismas reglas. Se reimplementan y, a partir de ahí, empiezan a divergir sin que nadie lo note.
- situación 03
Una capa compartida
Las reglas, los permisos y el acceso a datos pasan a vivir en un backend con un contrato estable que todos los consumidores usan igual.
Señales de que ha llegado ese momento
No hace falta que se cumplan todas. Con dos o tres, normalmente ya conviene sacar la lógica del frontend.
- Una web y una app móvil necesitan compartir exactamente las mismas reglas.
- Varios frontends consumen y muestran la misma información.
- Clientes o partners externos necesitan acceso controlado a ciertos datos.
- Las reglas de negocio son demasiado importantes para vivir en el código del frontend.
- La autenticación y los permisos necesitan su propia capa.
- El producto tiene que exponer capacidades estables en el tiempo.
- Varios equipos consumen el mismo backend con ritmos distintos.
- El producto está creciendo más allá de una arquitectura centrada en el CMS.
Una fuente de verdad
Una capacidad, varios consumidores
El objetivo no es conectar sistemas: es que exista un único sitio donde una capacidad del negocio está definida, y que todo lo demás la consuma desde ahí.
- Usuarios e identidades
- Catálogo
- Precios y tarifas
- Reservas y disponibilidad
- Permisos
- Cálculos
- Documentos
- Notificaciones
-
Web
El sitio público consume los mismos datos y las mismas reglas de cálculo.
-
App móvil
Sin duplicar lógica: la app pide capacidades, no reimplementa comportamiento.
-
Portal de cliente
Cuentas, documentos y operaciones expuestas con permisos propios.
-
Partner externo
Acceso limitado a un subconjunto concreto de capacidades.
-
Herramienta interna
El equipo opera sobre las mismas reglas que ve el cliente final.
el principio
La misma regla de negocio no debería implementarse por separado en cada aplicación. Si el cálculo de un precio vive en tres sitios, tarde o temprano dará tres resultados distintos.
Una única lógica reduce duplicidades, evita comportamientos distintos entre canales y permite evolucionar el producto desde un único punto.
Esa capacidad compartida puede entregarse de cuatro formas distintas. Un proyecto puede necesitar una sola o varias, pero todas se apoyan en las mismas reglas y en el mismo acceso a datos.
- 01
Backend de producto
La capa completa de una aplicación digital: reglas de negocio, identidad, permisos, flujos de trabajo y acceso a datos.
producto nuevo · lógica dispersa - 02
API para web y apps
Un contrato estable que consumen el frontend web, la app móvil u otra superficie del mismo producto.
frontend headless · app móvil - 03
API para clientes y partners
Acceso externo controlado: qué capacidades se exponen, con qué credenciales, con qué límites y con qué documentación.
credenciales · alcances · límites - 04
Servicio especializado
Una capacidad aislada fuera de la aplicación principal: documentos, cálculos, colas o trabajos programados.
procesos asíncronos
Contrato y capas
Una API no es solo responder JSON
Cualquier endpoint puede devolver datos. Lo que hace útil a una API es que cada petición atraviese siempre las mismas capas —contrato, permisos, validación y reglas— y que la respuesta, incluida la de error, sea previsible.
capas que atraviesa puede devolver
- capa 01
Contrato de API
Los recursos, las acciones y las respuestas que los consumidores pueden dar por estables. Es la parte que otros equipos leen, integran y de la que dependen.
400 · 404 - capa 02
Autenticación y permisos
Quién es cada consumidor y qué está autorizado a hacer con cada recurso. Una misma llamada puede ser legítima para un usuario y no para otro.
401 · 403 - capa 03
Validación
Lo que entra se comprueba antes de llegar a las reglas de negocio, y lo que no es válido devuelve un error explicable en lugar de un fallo interno.
422 - capa 04
Reglas de negocio
El comportamiento real del producto: cálculos, estados, condiciones y decisiones. Es la capa que no debería estar duplicada en ningún frontend.
409 - capa 05
Servicios, trabajos y colas
Lo que no debe resolverse dentro de una petición: procesos largos, envíos, generación de documentos o sincronizaciones que pueden fallar y reintentarse.
202 · reintento - capa 06
Acceso a datos
Cómo se leen y se escriben los datos, con la consistencia que el negocio necesita y sin exponer más información de la que cada consumidor requiere.
campos mínimos
Cualquier capa puede detener la petición: credenciales, permisos, validación o una regla que no se cumple. También ahí la respuesta está definida —un código previsible y un mensaje que el consumidor puede tratar sin adivinar.
error → respuesta documentadaCuando un proyecto «tiene API» pero falla en producción, casi nunca es por la capa 01: suele ser porque alguna capa intermedia no existe —no hay validación, los permisos se comprueban en el sitio equivocado o la lógica está mezclada con el acceso a datos.
La app que ya está publicada sigue llamando a v1 y funcionando igual. La capacidad nueva se añade sin obligar a nadie a actualizar a la vez.
Continuidad
Una API útil hoy también debe poder cambiar mañana
Un backend vive más que el proyecto que lo estrena. Aparecerán consumidores nuevos, cambiarán reglas y se añadirán campos: el diseño tiene que absorber eso sin romper innecesariamente lo que ya funciona.
-
Versionado
Los cambios que rompen compatibilidad se hacen explícitos en lugar de silenciosos.
-
Compatibilidad
Cuando tiene sentido, lo antiguo sigue respondiendo mientras se migra lo nuevo.
-
Pruebas
El comportamiento acordado queda comprobado, no confiado a la memoria del equipo.
-
Fronteras claras
Cada parte del sistema tiene una responsabilidad, para poder cambiarla sin efectos laterales.
-
Despliegue controlado
Los cambios llegan a producción de forma verificable y reversible.
Fronteras del servicio
Qué no es este servicio
Construir una capa técnica nueva, conectar sistemas que ya existen y automatizar un proceso manual son cosas relacionadas, pero no el mismo trabajo. Si tu caso es uno de estos, el servicio correcto es otro.
- ¿Necesitas que dos sistemas que ya existen intercambien información? Integraciones técnicas El problema no es crear una capacidad nueva, sino sincronizar dos que ya funcionan por separado. ecommerce ↔ ERPweb ↔ software de gestión
- ¿Necesitas que una secuencia manual se ejecute sola? Automatización de procesos Existe un proceso que ya se hace a mano y lo que falta es que se dispare y encadene sin intervención. formulario → CRM→ email → tarea
- ¿Necesitas que tu web alimente el CRM y el proceso comercial? Integraciones CRM El foco está en los datos de contacto y oportunidad llegando bien al equipo de ventas. leads · oportunidadesseguimiento comercial
- ¿Necesitas una interfaz para que tu equipo trabaje? Herramientas internas Lo que hace falta es la pantalla donde operar, no la capacidad técnica que hay debajo. panel de gestiónback office a medida
En todos esos proyectos pueden usarse APIs, y de hecho se usan. Pero usar una API no es lo mismo que construir la capa de capacidades de un producto.
¿Todavía no está claro qué capa necesita el proyecto? Puede ayudar la diferencia entre una API a medida y una integración técnica.
Casos reales de backend y API
Cuándo tiene sentido construir esta capa
Escenarios donde el trabajo es claramente desarrollo de backend o de API, y no una integración ni una automatización.
- caso 01
Backend de una app móvil
La aplicación necesita usuarios, sesiones, datos y reglas de negocio, y no puede resolverlos por sí sola. Se construye un único backend que sirve a la app y queda preparado para que mañana lo consuma también la web, sin reescribir la lógica.
- caso 02
API para clientes y partners
Otras organizaciones necesitan consultar o enviar información a tu producto. Se define qué capacidades se exponen, con qué credenciales y con qué límites, y se documenta para que sus equipos técnicos puedan integrarse sin depender de llamadas y correos.
- 03
Producto web headless
El frontend se desacopla de la aplicación y consume una API propia, con su propio ritmo de despliegue.
- 04
Portal de cliente
Una API controlada que sirve datos de cuenta, documentos y operaciones concretas del negocio.
- 05
Backend de SaaS
Usuarios, permisos, planes, límites y servicios de aplicación como base de un producto que se vende.
- 06
Lógica de negocio compartida
Varios frontends dependen de la misma fuente de verdad para calcular, validar y decidir.
- 07
Servicio de procesamiento
Una capacidad dedicada a cálculos, generación de documentos o trabajos asíncronos.
Criterio técnico
La arquitectura más compleja no siempre es la mejor
Las tres opciones son legítimas. La decisión depende del problema, del equipo y de lo que el sistema tenga que soportar, no de cuál suena más avanzada.
- opción 01
Backend estructurado
Una sola aplicación bien organizada, con módulos y responsabilidades separadas por dentro. Resuelve limpiamente la mayoría de productos.
cuándoCuando un backend puede cubrir todo el dominio sin fricción entre equipos.
- opción 02
Servicio independiente
El backend principal se mantiene, y una capacidad concreta se separa porque tiene otro ciclo, otra carga u otro riesgo.
cuándoCuando una capacidad necesita de verdad su propio despliegue o escalado.
- opción 03
Arquitectura distribuida
Varios servicios con fronteras propias. Aporta independencia, pero añade coordinación, observabilidad y coste de operación.
cuándoCuando la escala, los límites organizativos o requisitos técnicos concretos lo justifican.
No partimos un sistema en microservicios para que la arquitectura parezca más sofisticada. Empezamos por la opción más simple que resuelve el problema, y separamos solo cuando hay una razón que se pueda explicar.
Cómo trabajamos
De la necesidad al contrato, y del contrato al sistema
El orden importa: primero se entiende quién va a consumir el backend y qué reglas son suyas; el contrato se acuerda antes de implementar, no después.
- 01
Necesidad y consumidores
Quién va a usar el backend y qué capacidades necesita de verdad.
- 02
Datos y reglas
Qué información y qué reglas pertenecen al sistema.
- momento clave 03
Contrato y arquitectura
Accesos, estructura de la API y fronteras técnicas.
- 04
Implementación
Construcción del backend y de los servicios necesarios.
- 05
Pruebas y seguridad
Comportamiento, permisos y escenarios de fallo.
- 06
Documentación y entrega
Que el sistema se entienda sin nosotros delante.
- 07
Evolución
Nuevos consumidores y capacidades sin romper lo anterior.
Acordar la estructura de la API antes de implementarla permite que el equipo de frontend, la app o el partner empiecen a trabajar en paralelo, y evita el escenario más caro: descubrir al final que la API no encaja con lo que la aplicación necesitaba.
Control y continuidad
Preparado para operar y continuar
Un backend profesional no termina cuando devuelve la respuesta correcta. También tiene que ser controlable, comprensible y mantenible por quien venga después.
Control
quién entra · qué puede hacer- Consumidor web · app · partner
- Identidad quién llama
- Permiso qué puede hacer
- Capacidad operación concreta
- Datos solo lo necesario
cada paso puede denegar la petición
-
Autenticación
Credenciales propias por consumidor, no una clave compartida por todo el mundo.
-
Autorización
Los permisos se comprueban en el backend, nunca se confían al cliente que llama.
-
Alcances
Cada credencial accede a un subconjunto explícito de capacidades y recursos.
-
Validación
Toda entrada se verifica: tipos, límites, coherencia y estado de las reglas.
-
Exposición mínima
Las respuestas devuelven los campos del caso de uso, no el registro completo.
-
Secretos y configuración
Claves y credenciales fuera del código, separadas por entorno.
-
Límites de uso
Control de volumen por consumidor para proteger el servicio y detectar usos anómalos.
-
Registro y errores
Traza de las operaciones relevantes y fallos previsibles en lugar de errores opacos.
Continuidad
quién puede seguir después-
Documentación de API
Recursos, parámetros, respuestas y errores, con ejemplos de uso reales.
-
Decisiones técnicas
Por qué está construido así y qué alternativas se descartaron.
-
Entornos y configuración
Qué necesita cada entorno para funcionar, cuando aplica al proyecto.
-
Pruebas
El comportamiento acordado, comprobable por quien continúe el trabajo.
-
Ejemplos de uso
Llamadas reales que otro equipo puede reproducir el primer día.
-
Traspaso
Sesión de entrega y acceso a todo lo necesario para operar el sistema.
-
Otro equipo puede continuar
Interno o externo: entender la API no debería exigir preguntarnos.
Según el alcance, la entrega puede incluir backend/API, documentación, pruebas, definición de permisos, configuración de entornos y criterios para su evolución.
espacio reservado
Este bloque está preparado para publicar un artefacto técnico real y anonimizado de proyecto, en lugar de una captura de ejemplo.
- documentación OpenAPI
- esquema de la API
- colección de pruebas
- registro de decisiones
- documentación de endpoints
criterio técnico · no constituye una garantía de seguridad absoluta
Colaboración técnica
Backend y APIs para agencias y equipos técnicos
Si vuestro equipo lleva el producto, el diseño o el frontend y necesitáis la capa de backend, podemos asumirla: definición de arquitectura, implementación desde cero o a partir de una especificación existente, documentación y pruebas. En segundo plano y con vuestra marca por delante.
- definición de arquitectura
- implementación de backend y API
- a partir de especificación
- documentación
- testing
- trabajo con equipos de frontend y producto
- marca blanca
Servicios relacionados
Servicios que suelen ir alrededor
Un backend rara vez es el único trabajo. Según el proyecto, antes o después aparece la integración con lo que ya existe, la automatización de un proceso o la interfaz que usa el equipo.
- / integraciones-tecnicas
Integraciones técnicas
Cuando dos sistemas que ya existen tienen que intercambiar información de forma fiable.
conectar - / automatizacion-procesos-web
Automatización de procesos
Cuando el problema es una secuencia manual que debería ejecutarse sola.
automatizar - / herramientas-internas-a-medida
Herramientas internas
La interfaz desde la que tu equipo trabaja sobre las capacidades del backend.
operar - / desarrollo-web-a-medida
Desarrollo web a medida
La superficie que consume el backend: web, aplicación o producto completo.
crear - / integraciones-crm
Integraciones CRM
Cuando lo importante es que los datos de cliente lleguen bien al proceso de venta.
comercial - / mantenimiento-web
Mantenimiento y evolución
Para que el backend siga vivo, actualizado y creciendo con nuevos consumidores.
continuidad
Si no tienes claro cuál encaja, describe el caso y te decimos qué servicio corresponde antes de presupuestar nada.
Dudas frecuentes
Preguntas sobre backend y APIs
Lo que más nos preguntan antes de empezar un backend o una API. Si tu duda no está aquí, escríbenos y te respondemos directamente.
Cuando el producto tiene reglas propias que no deberían vivir en el frontend, cuando hay más de una aplicación que necesita las mismas capacidades o cuando la autenticación y los permisos empiezan a ser un tema en sí mismos. Si todo lo resuelve una web con un CMS y no hay otros consumidores, probablemente todavía no lo necesitas.
El backend es la capa que contiene las reglas, los datos y los permisos de un producto. La API es la puerta por la que otros consumen esas capacidades. Una integración es hacer que dos sistemas que ya existen intercambien información. Construir un backend y una API es crear algo nuevo; integrar es conectar lo que ya está.
No siempre, pero es una opción sólida y bien entendida para la mayoría de proyectos. Hay casos donde encajan mejor otros enfoques, por ejemplo cuando el cliente necesita composiciones de datos muy variables o cuando hay comunicación entre servicios con requisitos distintos. La decisión se toma según los consumidores reales, no por preferencia.
Sí. Es uno de los casos más habituales: autenticación, usuarios, datos y reglas de negocio servidos a través de una API que consume la app. Podemos trabajar con vuestro equipo de aplicación o con el estudio que la desarrolle, acordando el contrato de la API antes de que ninguna de las dos partes implemente.
Sí, y normalmente es el motivo para construirla. Lo importante es que el diseño contemple desde el principio que habrá varios consumidores con permisos y necesidades distintas: eso condiciona la estructura de recursos, los alcances de acceso y la forma de versionar los cambios.
Con credenciales propias por consumidor y comprobación de permisos siempre en el backend, nunca confiando en lo que envía el cliente. Cada credencial tiene un alcance explícito sobre qué recursos puede leer o modificar, y las operaciones relevantes quedan registradas para poder revisarlas después.
Sí. La documentación forma parte de la entrega: recursos, parámetros, respuestas, errores y ejemplos de uso. También dejamos por escrito las decisiones técnicas relevantes, porque entender por qué el sistema está construido así es tan importante como saber cómo llamarlo.
Es uno de los objetivos con los que trabajamos. Estructura clara, fronteras definidas, pruebas del comportamiento acordado y documentación suficiente para que un equipo interno o un tercero pueda continuar el proyecto. Si preferís que sigamos nosotros, también es posible, pero no debería ser una obligación técnica.
Se planifica. Los cambios que no rompen compatibilidad pueden añadirse sin más; los que sí la rompen se hacen explícitos, normalmente con una versión nueva y un periodo en el que la anterior sigue respondiendo mientras los consumidores migran. Lo que evitamos es que un consumidor externo se entere de un cambio porque algo dejó de funcionar.
Probablemente no, al menos para empezar. Un backend bien estructurado resuelve la mayoría de productos con mucho menos coste de operación. Separar servicios tiene sentido cuando hay una razón concreta —escala, equipos independientes, requisitos técnicos distintos— y esa razón se puede explicar sin recurrir a la tendencia del momento.
Sí, y muchas veces el backend que construimos consume APIs externas: pagos, envíos, facturación o servicios sectoriales. Pero si el proyecto consiste sobre todo en conectar sistemas que ya existen entre sí, el servicio que encaja es integraciones técnicas, no el desarrollo de una capa nueva.
Sí. Un backend en producción necesita actualizaciones, revisión de dependencias, ajustes cuando cambian las reglas y trabajo adicional cada vez que aparece un consumidor nuevo. Puede plantearse como mantenimiento continuado o como evoluciones puntuales, según cómo trabaje tu equipo.
Siguiente paso
Cuéntanos qué necesita poder hacer tu producto
Antes de implementar nada, ayudamos a decidir si lo que necesitas es un backend, una API, un servicio independiente u otra arquitectura, y qué consumidores tiene que soportar.
Sin compromiso · Revisión inicial del caso · Respuesta en 24 h