# Backends que conectan, escalan y se documentan solos. URL: https://freshsoftware.es/desarrollo-de-apis/ > APIs REST con OpenAPI/Swagger, GraphQL, autenticación OAuth2 y JWT. Backends en Node.js, PHP, Python y Go. Microservicios si hacen falta, monolito modular si no. ## Desarrollo de APIs REST, GraphQL y microservicios APIs REST con OpenAPI/Swagger y GraphQL. Autenticación con OAuth2 y JWT. Documentación interactiva, versionado, rate limiting y testing automatizado. Backends en Node.js, PHP, Python y Go. Microservicios escalables y bien documentados. ## Cuatro escenarios típicos que resolvemos. Una API es el contrato entre dos sistemas. Lo importante es entender qué se comunica y cómo. - **Para apps móviles** — Backend de tu app y panel admin web compartido. Auth, push, sincronización offline. - **Para integrar B2B** — Conectar con partners, proveedores, marketplaces. Webhooks, OAuth, contratos OpenAPI. - **Para escalar** — Microservicios, alta concurrencia, queues y caché. Servicios que aguantan miles de peticiones por segundo. - **Documentación viva** — OpenAPI auto-generado, Swagger UI, contratos versionados. Tus integradores no te llamarán por preguntas básicas. ## ¿Necesitas conectar sistemas? Cuéntanos qué sistemas tienes y qué necesitas integrar. Te proponemos arquitectura en una primera llamada. ## Lo que más nos preguntan ### ¿REST o GraphQL? ¿Cuál conviene en mi caso? REST: simple, cacheable, mucho tooling, ideal para APIs públicas y CRUD claros. GraphQL: el cliente pide exactamente los campos que necesita en una sola query, útil cuando hay múltiples frontends con necesidades distintas o el over-fetching es un problema. tRPC si el cliente y servidor son TypeScript. Te ayudamos a decidir según caso. ### ¿Cómo aseguráis una API a nivel producción? OAuth2 para autenticación con terceros o entre servicios. JWT para sesiones stateless. API keys con rate limiting por IP y por key. TLS obligatorio. Validación estricta de input (Zod, Joi, class-validator). CORS configurado correctamente. Auditoría con OWASP API Top 10. WAF (Cloudflare, AWS WAF) cuando se necesita. ### ¿Qué incluye la documentación que entregáis? OpenAPI 3.x con todos los endpoints, parámetros, schemas request/response, códigos de error y ejemplos reales. UI interactiva (Swagger UI o Redoc) donde el integrador puede probar la API. Postman collection. SDKs auto-generados (TypeScript, Python, etc.) si se necesita. Changelog claro entre versiones. ### ¿Cómo versionáis las APIs sin romper integraciones existentes? Versionado en URL (/v1, /v2) o en header. Política de deprecación clara con plazos (mínimo 6 meses de aviso antes de eliminar un endpoint). Schemas versionados con compatibilidad hacia atrás cuando es posible. Comunicación proactiva a integradores antes de cambios breaking. ### ¿Hacéis microservicios o monolitos? ¿Qué recomendáis? Honestamente: monolito modular bien hecho > microservicios mal hechos. La mayoría de proyectos empiezan con monolito modular (Domain-Driven Design, módulos bien separados). Sólo migramos a microservicios cuando hay razón clara: escala diferenciada por módulo, equipos grandes independientes, o requisitos de despliegue separado. Te decimos honestamente cuál encaja. ## Servicios relacionados - integración entre sistemas: https://freshsoftware.es/integracion-con-terceros/ - frontends que consumen las APIs: https://freshsoftware.es/desarrollo-de-aplicaciones-web/ - apps móviles con backend API: https://freshsoftware.es/app-moviles/