Skip to main content

 Services

Web services from /about to /webhooks

group autosuggest

/groups/{group}/autosuggest [GET]

Description

This service returns the list of result suggestions from a prefix match on a set of fields. If there are multiple words in term, only the last word is used for prefix matching with an AND on the other words.

Parameters

NameDescriptionRequiredTypeDefault
termThe prefix for the terms to use for the AutoSuggestyesstring
fieldsA comma-separated list of fields to search innostringspstitle,psfilename,psdocid,psid
filtersA comma-separated list of field:term pairs to use as filtersnostrings
resultsThe maximum number of results to returnnointeger10

Although the term parameter isn't strictly required, failing to specify a term always returns an empty result set.

Permission

This service is restricted to guest and higher.

Response

Example XML output:

<autosuggest term="lorem">
  <query empty="false" predicate="...">
    <suggestion-query>
      <terms>
        <term field="pstitle" text="lorem"/>
        <term field="psfilename" text="lorem"/>
        <term field="psdocid" text="lorem"/>
        <term field="psid" text="lorem"/>
      </terms>
      <condition>pstype:document</condition>
    </suggestion-query>
  </query>
  <results page="1"
           page-size="10"
           total-pages="1"
           total-results="2"
           first-result="1"
           last-result="2">
    <result score="1.6665791">
      <field name="psid">4482</field>
      <field name="pstitle">lorem_ipsum.psml</field>
      ...
    </result>
    <result score="1.6665700">
      <field name="psid">4400</field>
      <field name="pstitle">lorem.psml</field>
      ...
    </result>
  </results>
</autosuggest>

Error Handling

No specific errors expected for this service.

Created on , last edited on