Using Query String in REST Web Services -


i thought 1 main characteristic , reason using rest web services use path parameters rather query parameters. many publicly available rest web services use query parameters.

am wrong in thinking query parameters not supposed used in rest web services? there recommendation or rule not using query parameters in rest web services?

the query string can still used in rest web services not in same way normal.

you have think of url key resource. url unique identifier resource. example

http://example.com/products/123   -- 123 id of products.

accessing /products return full list of products. adding id return specific product.

the problem using slashes every filter

what if want order product in specific way? 

http://example.com/products/united-states

well, there ambiguity @ first look. united-states id? ambiguity can solved saying id represented \d+. correct.

ok our first parameters made of words country.

now lets want add more filters, lets try , add more slashes.

http://example.com/products/united-states/home/asc

but don't want united states products only! still want home products.

http://example.com/products/home/asc

wait... home country? i'm not sure now, it's kind of ambiguous... , if want add filter tomorrow? do... add more slashes?

the url becomes cluttered , full of ambiguous parameters optional @ first , become obligatory because of ambiguity.

my advice

the correct way, me, use query string thing specific query. because, can sort query in way want, still same query. query products.

so form should like

http://example.com/products -- products http://example.com/products/{id} -- specific 1 http://example.com/products/?country=united-sites -- filtered

this way can add new filters anytime want , keep urls clear , won't ever break though change filters.

more information

if want more information really, advise look @ this conference david zülke, guy working symfony framework. talks lot of things of rest web-services, talk urls, , how build them (mainly 16 30 minutes).

you can @ apigee website. have lot of videos (and books) rest. more this video, on topic here.


Comments

Post a Comment

Popular posts from this blog

Why does Ruby on Rails generate add a blank line to the end of a file? -

running rails generate controller foo home results in: class foocontroller < application controller def home end end (there's nothing on line in actual file, blank line) is there purpose blank line? it's common use newline indicate end of line, last line. many editors (like vi, use) add in newline silently. consensus text files (especially in unix world) should end in newline, , there have been problems historically if wasn't present. why should text files end newline? the tool used count lines in file "wc" counts newlines in file, without trailing newline show 3 instead of 4. it improves readability of templates used in generator. consider: https://github.com/rails/rails/blob/master/railties/lib/rails/generators/rails/controller/templates/controller.rb to remove trailing newline, template have last line of: end<% end -%> instead of: end <% end -%> that seems less readable me. the discussion below refers ...
Read more

keyboard - Smiles and long press feature in Android -

i've created android keyboard. how add features inserting smilies, , using long keypresses display symbols? to create long-press behavior allows select several options pop-up menu, follow guide (specifically pop-up menu section): http://developer.android.com/guide/topics/ui/menus.html smileys (also known emoticons) combination of keys, understood programs , parsed same way. have do, when clicks smiley face on keyboard, simulate pressing of key combination matching emoticon. example, when clicks smiley, should simulate key presses ':' , ')' :). here's list of emoticons: http://en.wikipedia.org/wiki/list_of_emoticons
Read more

node.js - Bad Request - node js ajax post -

i'm using express 3.0 , node v0.11.0. have button submits form , i'm using ajax post data json object node server. client code is: $('#contact').submit(function(e) { console.log('submit called'); var formdata = json.stringify($('form').serializeobject()); console.log(formdata); $.ajax({ url: "http://localhost:3000/savedata/", type: "post", datatype: 'json', data: {objectdata: formdata}, contenttype: "application/json", complete: function() { console.log('process complete'); }, success: function(data) { console.log('process sucess'); }, error: function() { console.log('process error'); }, }); return false; }); then on server: var express = require('express'); var app = express(); app.set('views', __dirname + '/views'); app.set('view engine', 'jade'); app.use(express.bodyparser());...
Read more