Abbiamo un'applicazione in cui esiste un'API per creare un documento con un POST e aggiornarlo con un PUT. Esiste un'API separata per condividere documenti con gli utenti.
Ora, come dovremmo affrontare l'aggiornamento dell'elenco di utenti con cui è condiviso il documento?
Dovrebbe essere un POST o PUT che in realtà cancella l'intera associazione e la sostituisce con nuova?
In che modo cose come queste sono implementate in modo accurato?
Quando si utilizza il protocollo HTTP per l'API REST (la situazione comune), PUT viene utilizzato per sostituire una risorsa e POST per modificare una risorsa.
Se l'elenco dei destinatari del documento è modellato come sub-risorsa del tuo documento, puoi utilizzare POST per aggiungere utenti all'elenco o PUT per sostituire l'intero elenco, qualunque sia il più conveniente per te e / o per gli utenti della tua API.
Se l'elenco dei destinatari del documento non viene modellato come sub-risorsa, ma è una semplice proprietà del documento, è necessario utilizzare POST (sul documento) per modificare l'elenco senza sovrascrivere il resto della risorsa del documento.