web services - What is the best URI template for retrieving grouped counts of a particular resource in a REST API? -

-

i have rest api exposes uri return collection of employees in json. uri of following format:

http://webservice/employees

i want expose uri returns number of employees grouped by, say, office work in , further information office. example:

items: [{            officeid: 1,            officename: "big office",            switchboardtel: "123456789",            numemployees: 100         },         {            officeid: 2,            officename: "small office",            switchboardtel: "987654321",            numemployees: 30         },         ... // etc.        ]

what suitable uri this? thinking given returns information offices (along number of employees), perhaps information should retrieved via "offices" resource:

http://webservice/offices

alternatively, following uri more suitable?

http://webservice/employees?groupby=office

in opinion, seems wrong response returns information offices, rather employees, along employee count.

say wanted expose uri returned number of employees grouped age... belong "employees" resource, such as:

http://webservice/employees?groupby=age

...or better suited creating "ages" resource:

http://webservice/ages

in opinion, "groupby=age" option seems best here...but kind of makes uri formats inconsistent.

basically, want consistent uri format count of employees grouped criteria - , response contain information grouping.

thanks in advance help.

tom


Comments

Post a Comment

Popular posts from this blog

django - How can I change user group without delete record -

-
on website user have 1 group. , user can change group. it's made user.groups.clear() and user.groups.add(new_group) but it's not efficient, because there 2 sql query: delete, insert. how can change group update query? user , group related each other using manytomanyfield . means intersection table exists relating both entities, , if don't specify model map (using through attribute) django creates 1 you. looking @ sources django.contrib.auth.models see that's case. fortunatly, can access intermediary model using through attribute of manager (in case, user.groups.through ). can use regular model. example: >>> alice = user.objects.create_user('alice', 'alice@example.com', 'alicepw') >>> employee = group.objects.create(name='employee') >>> manager = group.objects.create(name='manager') >>> alice.groups.add(employee) >>> alice.groups.all() [<group: employee...
Read more

java - Need to add SOAP security token -

-
i need set custom soap header attribute on jax-ws generated webservice client. case webservice calls must go through proxy server requiring specific token (recieved web request header) present in soap request header. e.g.: 1 carserviceservice service = null; 2 service = new carserviceservice(new url(url), new qname(qname); 3 carserviceendpoint port = service.getcarserviceport(); it seems in line 3 wsdl retrieved , call fails due missing security token. 1 point direction on how done? a detailed example has been mentioned here: creating , deploying jax-ws web service on tomcat 6 this article shows how create , use security token .
Read more

java - EclipseLink JPA Object is not a known entity type -

-
i have strange problem eclipselink , object want persist. have 1 object (keypointlistimpl) stores object keypointimpl in list. persisting keypointimpl objects works great if try persist keypointlistimpl object java.lang.illegalargumentexception says object keypointimpl isn't known entity type. here keypointimpl code: @entity @table(name="keypoints") public class keypointimpl implements keypoint { @id @generatedvalue(strategy = generationtype.identity) private int id; @enumerated(enumtype.string) private detectortype keypointtype; private float x; private float y; private float size; private float angle; private float response; private int octave; private int classid; ... } here keypointlistimpl code: @entity @table(name="keypointlists") public class keypointlistimpl implements keypointlist { @id @generatedvalue(strategy = generationtype.identity) private int id; @onetoone(cascade={ca...
Read more