Desarrollo backend en Java: APIs, datos e integraciones

Un backend Java sólido se reconoce por cómo se comporta cuando algo va mal: devuelve errores comprensibles, no pierde datos ante un reintento, degrada de forma controlada cuando una dependencia falla y permite entender qué ha ocurrido sin reproducirlo. Esas propiedades dependen del contrato de la API, del modelo de datos, de dónde están los límites transaccionales y de qué se registra en cada operación.

Se diseña a partir de los recursos del dominio y de los casos de uso reales del consumidor, no exponiendo el modelo de base de datos, y se versiona desde la primera publicación. Conviene usar DTO explícitos distintos de las entidades de persistencia, versión en la ruta, cambios aditivos siempre que sea posible, errores con estructura uniforme y contrato documentado con OpenAPI generado desde el código.

Distinguiendo entre errores de negocio esperados y fallos técnicos, y traduciéndolos a respuestas coherentes en un único punto en lugar de en cada controlador. Un error de negocio devuelve un código específico que el cliente puede tratar; un fallo técnico es un 5xx que se registra con contexto. Conviene incluir un identificador de correlación en cada respuesta de error y no exponer nunca trazas de excepción.

En el caso de uso, no en el repositorio ni en el controlador: la transacción debe abarcar exactamente la operación de negocio que tiene que ser atómica. Una regla fiable es que dentro de una transacción no haya ninguna llamada de red que no sea a la propia base de datos; las notificaciones, la publicación de eventos y las llamadas a terceros van fuera, y si deben ser atómicas se resuelven con el patrón outbox.

Autorización comprobada en el servidor sobre cada operación, validación de entrada declarativa aplicada en el límite del sistema, consultas siempre parametrizadas, secretos en un gestor externo fuera del repositorio y análisis automático de vulnerabilidades de las dependencias en el pipeline, ya que la mayoría de los incidentes llegan por esa vía.