Using the post command, Post limitations, Structure of the post body – Google Search Appliance Protocol Reference User Manual
Page 7
Google Search Appliance: Search Protocol Reference
Request Format
7
Using the POST Command
In some instances, your query strings might exceed the 2KB URL length limit of GET requests and be
truncated. This might happen when you submit dynamic navigation queries containing a large number
of metadata filters. You can avoid this limitation by submitting POST requests instead, which have a
much larger body limit (10KB).
POST Limitations
POST support is only available for:
•
Requests for search service (/search)
•
Public search
•
Secure search, but only for cookie and basic authentication, and only when the Trusted Applications
feature is used (see
“Using Trusted Applications”
in Managing Search for Controlled-Access Content)
POST support is not available for other Universal Login Auth Mechanisms. You must use the GET
command for these.
If you are sending non UTF-8 data, you must include the ie parameter (described on
) in the
POST body. This parameter sets the character encoding that is used to interpret the query string. You
should also specify the access parameter (as shown in
Search Request Examples (POST command)
) in
the POST body when sending POST requests.
The following search parameters are not included by default in a POST request:
•
entqr--Sets the query expansion policy.
•
entqrm--Controls query expansions for meta tags.
•
entsp--Controls the use of the advanced relevance scoring parameters.
•
filter-Activates or deactivates automatic results filtering.
•
ip--Indicates the IP address of the user who submitted the search query.
•
tlen--Specifies the number of bytes that would be used to return the search results title.
•
ulang--Indicates the language of the user who submitted the search query
•
wc--Specifies the number of wildcard expansions for a wildcard expression.
•
wc_mc--Specifies whether or not the search appliance considers all words with * as wildcard terms.
If you want to include any of these parameters in a POST request, you must add them. For more
information about these parameters, see
Structure of the POST Body
The structure of the POST body is a URL-encoded query string. It is like the URL of a GET request, after
the question mark.