<div dir="ltr"><div><div><div>Hi folks,<br></div><br>Wanted to discuss how the /api/search URL(s) would look like.<br><br></div>To set the scope of the discussion right, I must mention that in this sprint we are working on supporting search on ID , URL and full text ( for title and description only ) of a workitem.<br><br><br></div><div><ol><li>The ID search is currently only on workitems. ( But in future it would be supported for other objects as well. Example, Users,etc. )<br><br>To search by ID --<br><br>/api/search/q<b>=id:4324</b>  <br>This is going to look up the workitem table <b>only</b>. <br><br><br></li><li><br>To search by URL --<br><br>/api/search/q<b>=url:<a href="http://demo.almighty.io/#/detail/71">http://demo.almighty.io/#/detail/71</a></b>  <br><br><br><br></li><li><br>Search by ID *AND* URL is not supported.<br>If a q=xxyzz  contains both URL and ID, we only pickup the URL and discard the rest.<br><br>Example.<br>/api/search/q=<b>id:4324</b>+<b>url:<a href="http://demo.almighty.io/#/detail/71">http://demo.almighty.io/#/detail/71</a><br><br></b>is effectively<br><br><b> </b>/api/search/q=<b>url:<a href="http://demo.almighty.io/#/detail/71">http://demo.almighty.io/#/detail/71</a><br><br><br></b></li><li><br>Free text search is supported only on workitem title and description<br><br>/api/search/q:=<b>title:some title substring</b>+<b>description:some description substring<br></b><br><b><br></b></li><li><br>The delimiter for multiple clauses ( we shall support "AND" now ) will be "+" . ( inspired from Github ) as already used above. We need to consider situations where the string itself contains a "+" by escaping them properly.<br><br><br></li><li>if the search query contains a mix of ID, URL , title,description :<br>The order in which we are going to look for fields to make a decision on the search is:<br><br>1. URL<br>2. ID <br>3. title and description ( for free text search )<br><br><br><br><br>Let me know your thoughts :)<br><br><br>-<br>Shoubhik<br><br><br></li></ol></div></div>