Make an auto-completion query
Use this API to query an auto-completion index.
Requirement: OpenSearchServer v1.5
Call parameters
URL: /services/rest/index/{index_name}/autocompletion/{autocompletion_name}}?prefix={prefix}&rows{rows}
Method: GET
Header:
- Accept (optional returned type):
application/json
orapplication/xml
URL parameters:
- index_name (required): The name of the index.
- autocompletion_name (required): The name of the auto-completion item.
QUERY parameters:
- prefix (required): The characters used to find expressions in the auto-completion index.
- rows (optional): The number of terms to return.
Success response
The auto-completion item has been populated.
HTTP code:
200
Content (application/json):
{
"successful": true,
"info": null,
"terms": [
"OpenSearchServer",
"OpenSearchServer Search",
"OpenSearchServer Search Engine",
"OpenSearchServer Search Engine API",
"OpenSearchServer OpenSearchServer",
"OpenSearchServer documentation",
"OpenSearchServer 1.3",
]
}
Error response
The build failed. The reason is provided in the content.
HTTP code:
500
Sample call
Using CURL:
curl -XGET http://localhost:8080/services/rest/index/my_index/autocompletion/my_expressions?prefix=open&rows=10
Using jQuery:
$.ajax({
type: "GET",
dataType: "json",
url: "http://localhost:8080/services/rest/index/my_index/autocompletion/my_expressions?prefix=open&rows=10"
}).done(function (data) {
console.log(data);
});