Operazioni non CRUD in un servizio RESTful

Qual è il modo "RESTful" di aggiungere operazioni non CRUD a un servizio RESTful? Supponiamo che io disponga di un servizio che consente l'accesso CRUD a record come questo:

GET /api/car/123           <- Returns information for the Car object with ID 123
POST /api/car              <- Creates a new car (with properties in the request)
PUT /api/car/123           <- Updates car 123 (with properties in the request)
DELETE /api/car/123        <- Deletes car 123    
POST /api/car/123/wheel/   <- Creates a wheel and associates it to car 123

Se voglio cambiare il colore dell'auto, POST /api/car/123includerei semplicemente una variabile POST per il nuovo colore.

Ma supponiamo che io voglia acquistare un'auto e che l'operazione sia più complicata del semplice aggiornamento della proprietà di "macchina di proprietà" di un record "utente". È RESTful fare semplicemente qualcosa come POST /api/car/123/purchase, dove "acquisto" è essenzialmente un nome di metodo? O dovrei usare un verbo HTTP personalizzato, come PURCHASEinvece di POST?

O le operazioni non CRUD sono completamente al di fuori dell'ambito di REST?

Pensa all'acquisto come a un'entità aziendale o a una risorsa nel dizionario RESTful. Detto questo, effettuare un acquisto significa creare una nuova risorsa. Così:

POST /api/purchase

effettuerà un nuovo ordine. I dettagli (utente, auto, ecc.) Devono essere referenziati tramite id (o URI) all'interno dei contenuti inviati a questo indirizzo.

Non importa che ordinare un'auto non sia solo un semplice INSERIMENTO nel database. In realtà, REST non riguarda l'esposizione delle tabelle del database come operazioni CRUD. Dal punto di vista logico stai creando un ordine (acquisto), ma il lato server è libero di eseguire tutte le fasi di elaborazione che desidera.

Puoi persino abusare ulteriormente del protocollo HTTP. Usa l' Locationintestazione per restituire un collegamento all'ordine appena creato, scegli attentamente i codici di risposta HTTP per informare gli utenti sui problemi (lato server o lato client), ecc.

Il modo RESTful da quanto ho capito è che non hai bisogno di nuovi verbi HTTP, c'è un nome da qualche parte che significherà quello che devi fare.

Acquistare una macchina? Beh, non è quello

POST /api/order

Quello che stai davvero facendo è creare un ordine. Quindi aggiungi un'altra risorsa per l'ordine e la pubblicazione e inseriscila durante il processo di ordine.

Pensa in termini di risorse piuttosto che di chiamate ai metodi.

Per finalizzare l'ordine che probabilmente avresti POST / api / order // completato o qualcosa di simile.

Ritengo che le API REST siano d'aiuto in molti più modi rispetto alla semplice fornitura di semantica. Quindi non è possibile scegliere lo stile RPC solo a causa di alcune chiamate che sembrano avere più senso nello stile operativo RPC. L'esempio è l'API di Google Maps per trovare indicazioni tra due luoghi. Assomiglia a questo: http://maps.googleapis.com/maps/api/directions/json?origin=Jakkur&destination=Hebbal

Avrebbero potuto chiamarlo "findDirections" (verbo) e trattarlo come un'operazione. Piuttosto hanno fatto "direzione" (sostantivo) come una risorsa e hanno trattato la ricerca di direzioni come una query sulla risorsa delle indicazioni stradali (sebbene internamente non possa esserci alcuna risorsa reale chiamata direzione e potrebbe essere implementata dalla logica aziendale per trovare le direzioni in base ai parametri).