Inefficienza della catena di chiamate per la selezione di una carriera

[giograno]

Per come sono strutturate le API al momento, è decisamente tortuosa la sequenza di call da fare per generare la home di uno studente. Le principali API da chiamare in questo caso sono:

• testCredentials, che testa le credenziali e restituisce una serie di info sullo studente (matricola, corso, ecc..);
• listCareers che restituisce la lista delle carriere per uno studente (con un valore id che può essere usato come parametro opzionale careerId in ogni altra API sviluppata per far riferimento a una specifica carriera);
• getRecordBook che restituisce media e tutti gli esami dello studente. Anch'esso accetta il parametro opzionale careerId per recuperare una specifica carriera;

L'ordine delle chiamate sarebbe quindi:

1. testCredentials: testo le credenziali; mi vengono restituite di default alcune info basilari relative all'ultima carriera dello studente (in quanto non possiamo chiamare l'API con alcun careerId);
2. listCareers: ricevo elenco carriere; se ce n'è più di una, prospetto la scelta all'utente e salvo il careerId da qualche parte;
3. testCredentials: richiamo nuovamente questo metodo stavolta con il careerId che scelto dall'utente per ricevere le nuove info basilari sulla stessa;
4. getRecordBook: con la careerId scelta.

A mio avviso potrebbe essere gestita meglio questa situazione, ad esempio scorporando la parte relativa alla info basic sullo studente dall'API per le credenziali, o incorporare la lista delle carriere in quest'ultima API.

[giograno]

Il test e il caching delle credenziali può essere fatto con listCareers, evitando la doppia chiamata a testCredentials. Tuttavia il nome di quest'ultima API è decisamente fuorviante.