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 AutoSuggest (maximum 100 characters)yesstring
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

Error codes
0x1507If the term is not valid
Created on , last edited on