Azione personalizzata nel servizio RESTful

Question

Ho letto articoli sui servizi RESTful per un po 'e ho compreso l'importanza dell'utilizzo di VERBS contro RISORSE.

Ma c'è una cosa che non riesco a capire. Cosa succede se abbiamo bisogno di invocare una determinata azione che non fa parte di CRUD?

Ad esempio, si consideri che voglio far saltare un gatto. Quale formato dovremmo usare?

È il seguente RESTful?

http://host/cats/123/jump 

Answer 1

Se cats/123 rappresenta una risorsa poi pensare in questo modo: che la risorsa può avere molti stati (mangiare, camminare, dormire, saltare, pissing, ...). Quando si progetta un'API utilizzando lo stile architettonico REST, si desidera consentire a un'applicazione client di effettuare richieste consentite alla risorsa che modificherà il suo stato.

Nel contesto di cats/123, è possibile eseguire questa operazione attraverso una serie di richieste POST che causeranno la modifica dello stato della risorsa. Sfruttando la capacità di hypermedia in REST è possibile creare un processo come le richieste e le risposte mostrate di seguito. Si noti che i collegamenti consentiti cambiano in risposta al POST. Inoltre, l'applicazione client dovrebbe codificare le proprietà contenute nell'array Collegamenti e non l'URI effettivo contenuto nelle proprietà Href.

Richiesta:

GET cats/123 

Risposta:

{ 
    "Color" : "black", 
    "Age" : "2", 
    "Links":[ 
    { 
     "Food":"kibbles", 
     "Method":"POST", 
     "Href":"http://cats/123", 
     "Title":"Feed the cat" 
    }, 
    { 
     "Scare":"yell real loud", 
     "Method":"POST", 
     "Href":"http://cats/123", 
     "Title":"Scare the cat" 
    }] 
} 

Richiesta:

POST cats/123 

{ 
    "Food":"kibbles" 
} 

Risposta:

{ 
    "Color" : "black", 
    "Age" : "2", 
    "Tummy" : "full" 
    "Links":[ 
    { 
     "Sleep":"lap", 
     "Method":"POST", 
     "Href":"http://cats/123", 
     "Title":"Pet the cat" 
    }, 
    { 
     "Scare":"yell real loud", 
     "Method":"POST", 
     "Href":"http://cats/123", 
     "Title":"Scare the cat" 
    }] 
}