¿Cuándo elegirías GraphQL en vez de REST para un servicio nuevo?

Elige GraphQL cuando varios clientes distintos necesitan formas distintas de los mismos datos conectados y estás harto de traer datos de más o de publicar un endpoint por pantalla. Elige REST cuando la superficie es pequeña, la caché HTTP importa o los consumidores son máquinas y no pantallas. GraphQL no elimina la complejidad; la mueve de la proliferación de endpoints a la profundidad de resolvers, los límites de coste de consulta y una caché de la que ahora eres responsable.

Mi factor decisivo es la diversidad de clientes. Si hay un solo cliente web y los endpoints mapean limpiamente a pantallas, REST es menos maquinaria y te llevas gratis la caché HTTP, el comportamiento de CDN y poder depurar con curl. En cuanto tienes una app web, una app móvil y una integración de socios queriendo cada una porciones distintas del mismo grafo, REST se convierte o en cincuenta endpoints a medida o en respuestas gordas que los usuarios móviles pagan con sus datos. Ahí es cuando GraphQL compensa. Lo que me aseguro de que el equipo sepa de antemano es lo que viene con ello. Necesitas límites de profundidad y de coste de consulta o una sola consulta anidada puede machacar la base de datos, necesitas batching estilo dataloader o los resolvers producen consultas N más uno por defecto, y la caché HTTP casi deja de funcionar porque todo es un POST a una única URL, así que cacheas a nivel de resolver o de entidad. En un producto de tamaño medio yo honestamente empezaría con REST y añadiría GraphQL solo cuando aparezca un segundo cliente muy distinto.