Tengo una plataforma de rieles que mantengo. Tiene muchas aplicaciones web diferentes creadas sobre él. Sin embargo, ahora un cliente solicita una API para poder mantener a los usuarios en su sitio, pero aprovechar algunas de las tareas automatizadas que tenemos.
La plataforma se utiliza para crear aplicaciones de seguros y permite su compra en línea, además de proporcionar formas de descargar documentación relacionada con su póliza.
Entonces mi pregunta al construir la API es esta:
Cuando tengo que hacer un montón de cosas, como validate, crear una user, user profiley policy, más o menos al mismo tiempo. ¿Debo hacer 4 llamadas API separadas y hacer que el cliente cree 4 llamadas de su lado? ¿O debería tener una llamada que exceptúe muchos parámetros, que valide al cliente y cree las 3 cosas al mismo tiempo, simplificando las cosas para el cliente?
El cliente, en este caso, obtiene toda la información requerida al mismo tiempo, por lo que no es que haya un flujo natural en su aplicación donde se detenga y pueda hacer una llamada API a mi plataforma.
Después de haber estado en el lado del cliente usando muchas API antes, mi objetivo es hacerlo lo más simple posible para el cliente y hacer que solo hagan una llamada. Sin embargo, esto está dando lugar a bastante grande functionsen la API, de la que tampoco soy fanático.
¿Cómo sugieres que aborde esto?
Como nota, no tengo mucha confianza en la capacidad de los clientes para implementar una API complicada de su lado.
createUserProfilesin él tambiéncreateUser? Si no, entonces no lo expongas.