REST GET verbo con i parametri

Question

Sono seduto leggendo po 'di riposo con i miei compagni di squadra, stiamo scrivendo un'applicazione RoR che sta per esporre alcune delle sue funzionalità per il resto del mondo.

Il mio compito in questa squadra è quello di fare un ressource che espone i rapporti del journal. Se si chiama

http://root.com/journalreports

Si dovrebbe ottenere tutte le journalreports dal servizio. Questo funziona come un incantesimo, ma sono confuso su come creare correttamente una risorsa che espone una vasta gamma di pubblicazioni giornalistiche. Dovrei farlo

http://root.com/journalreports?range=1/2/2010;5/2/2010

O è illegale quando si parla di riposo a causa del? Gamma = interferenze?

Qual è il modo più corretto di dare un REST ressource alcuni parametri?

Answer 1

I parametri sono perfettamente OK, specialmente per le risorse di ricerca come nel tuo caso (interrogando un insieme di riviste).

ho recently answered domanda simile (percorso vs. parametro)

Answer 2

REST non rende il parametro di query "illegale" in alcun modo. È uno stile architettonico, principalmente per guidare l'applicazione scambiando le rappresentazioni. URI Considerando sono destinate ad essere opaco, non c'è differenza tra http://example.com/page/1 e http://example/?page=1 per esempio, per quanto RIPOSO concerne (in definitiva dipende dalle rappresentazioni che vengono inviati, ma la scelta o stile URI tende ad essere un dettaglio implementativo) .

ciò che conta è come il cliente sta andando a scoprire le URI dei vostri rapporti. HTML può farlo molto bene con moduli e parametri di query. Se il tuo servizio è per il consumo del browser o un altro agente non ha molta importanza, puoi usare gli stessi principi. Potresti avere moduli HTML (o equivalenti se il tuo client non è un browser) se vuoi che sia più flessibile o tramite link espliciti sulla tua pagina principale. (Potresti scoprire che è più semplice dividere l'intervallo in due parametri, come "da" e "a", se vuoi che sia più dinamico.)