REST - Creazione di risorse annidate con singolo POST

Question

Pensando in modo RESTful, è corretto utilizzare POST per creare in una singola chiamata una risorsa e la relativa sotto-risorsa? Nella mia applicazione ho la risorsa /notices/{notice} e la sotto-risorsa /notices/{notice}/photos/{photo}. Un {photo} non può esistere senza un {notice}, ma un {notice} non ha necessariamente foto. Normalmente, devo prima fare un POST per creare un avviso, poi un altro POST per aggiungere una foto.

Ora voglio consentire la creazione di un avviso con una foto direttamente allegata, consentendo la creazione di /notices/{notice} e /notices/{notice}/photos/{photo} con una singola richiesta POST a/avvisi/{notice}/foto/{foto}, con un contenuto multipart descrivendo entrambe le risorse (JSON per avviso, binario per la foto). Penso che restituirò l'intestazione Location solo per la sotto-risorsa.

In sostanza, voglio che questo impedisca ai client Android di inviare due richieste POST al server per caricare un avviso con una foto. È corretto? O viola i principi REST? Devo considerare di tenerli separati e fare due richieste diverse? O è sbagliato considerare le foto come entità separate dall'avviso? Devo conservare solo /notices/{notice} come risorsa, utilizzando PUT per aggiungere foto?

Qual è la soluzione migliore?

Answer 1

Sì, non c'è nulla di male nella creazione di sottocomponenti nello stesso momento in cui si crea la risorsa genitore. Sarebbe anche OK usare PUT invece di POST per fare ciò, poiché tutto sotto l'URL principale è parte di/appartiene alla risorsa che stai caricando.

EDIT:

Ora voglio per permettere la creazione di un avviso con una foto direttamente collegato, consentendo la creazione di /notices/{notice} e /notices/{notice}/photos/{photo} con un unico POST richiesta di /notices/{notice}/photos/{photo}

Questo non sono d'accordo con. Suggerisco il POST all'URL della risorsa della raccolta, /notices. Fornisci l'avviso e le sue foto come un'unica rappresentazione (corpo della richiesta). Il back-end quindi creerà risorse sia per l'avviso che per qualsiasi foto costituente.

Answer 2

Sebbene sia essenziale in molti casi, più modifiche/creazioni non sono formalmente affrontate dallo stile di architettura RESTful.

Il problema inizia quando è necessario segnalare errori su parte della raccolta e il problema si aggrava quando i guasti hanno cause diverse.

A avrà effetto sulla scelta dei giusti comandi Hypermedia che sono essenziali per il cliente per trovare una via da seguire nella transazione/conversazione specificata.

quindi il mio suggerimento è di avere un ciclo nidificato o richieste POST piuttosto che un POST singolare per creare risorse annidate, in modo che sia più semplice e più chiaro indirizzare ogni modifica dello stato delle risorse.