Documents - Autocomplete Post

Служба:: Search Service

Версия API:: 2026-04-01

Автоматически заполняет неполные термины запроса на основе входного текста и соответствующих терминов в индексе.

POST {endpoint}/indexes('{indexName}')/docs/search.post.autocomplete?api-version=2026-04-01

Параметры URI

Имя	В	Обязательно	Тип	Описание
endpoint	path	True	string (uri)	URL-адрес конечной точки службы поиска.
indexName	path	True	string	Имя индекса.
api-version	query	True	string minLength: 1	Версия API, используемая для данной операции.

Заголовок запроса

Имя	Обязательно	Тип	Описание
Accept		Accept	Заголовок Accept.
x-ms-client-request-id		string (uuid)	Непрозрачный, глобально уникальный, созданный клиентом идентификатор строки для запроса.

Текст запроса

Имя	Обязательно	Тип	Описание
search	True	string	Текст поиска, на котором будут основываться результаты автозаполнения.
suggesterName	True	string	Имя средства предложения, указанное в коллекции предлагаемых элементов, которые входят в определение индекса.
autocompleteMode		AutocompleteMode	Задает режим автозаполнения. Значение по умолчанию — oneTerm. Используйте 'twoTerms' для получения битумной черепицы и 'oneTermWithContext' для использования текущего контекста при создании автозаполненных терминов.
filter		string	Выражение OData, которое фильтрует документы, используемые для создания завершенных терминов, для результата автозаполнения.
fuzzy		boolean	Значение, указывающее, следует ли использовать нечеткое сопоставление для запроса автозаполнения. По умолчанию — false. Если задано значение true, запрос будет автоматически заполнять термины, даже если в тексте поиска есть замененный или отсутствующий символ. Хотя в некоторых сценариях это обеспечивает более эффективное взаимодействие, это приводит к снижению производительности, так как нечеткие запросы автозаполнения выполняются медленнее и потребляют больше ресурсов.
highlightPostTag		string	Тег строки, добавляемый для выделения попаданий. Необходимо задать с выделенным значениемPreTag. Если этот параметр опущен, выделение попаданий будет отключено.
highlightPreTag		string	Тег строки, который предопределен для выделения попаданий. Необходимо задать с помощью highlightPostTag. Если этот параметр опущен, выделение попаданий будет отключено.
minimumCoverage		number (double)	Число от 0 до 100, указывающее процент индекса, который должен быть покрыт автозаполнением, чтобы запрос был признан успешным. Этот параметр может быть полезен для обеспечения доступности поиска даже для служб с одной репликой. Значение по умолчанию — 80.
searchFields		string	Разделенный запятыми список имен полей, который следует учитывать при запросе автозаполненных терминов. Целевые поля должны быть включены в указанный подборщик.
top		integer (int32)	Количество автоматически заполненных терминов для извлечения. Это значение должно быть в диапазоне от 1 до 100. Значение по умолчанию равно 5.

Ответы

Имя	Тип	Описание
200 OK	AutocompleteResult	Запрос выполнен успешно.
Other Status Codes	ErrorResponse	Непредвиденное сообщение об ошибке.

Безопасность

api-key

Тип: apiKey
В: header

OAuth2Auth

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Области

Имя	Описание
https://search.azure.com/.default

Примеры

SearchIndexAutocompleteDocumentsPost

Образец запроса

HTTP

POST https://exampleservice.search.windows.net/indexes('example-index')/docs/search.post.autocomplete?api-version=2026-04-01


{
  "search": "p",
  "autocompleteMode": "oneTerm",
  "filter": "ownerId ne '1'",
  "fuzzy": true,
  "highlightPostTag": "</em>",
  "highlightPreTag": "<em>",
  "minimumCoverage": 80,
  "searchFields": "category, ownerId",
  "suggesterName": "sg",
  "top": 10
}

Пример ответа

Код состояния:: 200

{
  "@search.coverage": 100,
  "value": [
    {
      "text": "purple",
      "queryPlusText": "<em>purple</em>"
    },
    {
      "text": "pink",
      "queryPlusText": "<em>pink</em>"
    }
  ]
}

Определения

Имя	Описание
Accept	Заголовок Accept.
AutocompleteItem	Результат запросов автозавершения.
AutocompleteMode	Задает режим автозаполнения. Значение по умолчанию — oneTerm. Используйте 'twoTerms' для получения битумной черепицы и 'oneTermWithContext' для использования текущего контекста при создании автозаполнения терминов.
AutocompleteRequest	Параметры для нечеткого сопоставления и других поведения запросов автозаполнения.
AutocompleteResult	Результат запроса автозаполнения.
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Сведения об ошибке.
ErrorResponse	Распространенный ответ об ошибке для всех API Azure Resource Manager для возврата сведений об ошибке для неудачных операций. (Это также следует формату ответа об ошибках OData.).

Accept

Перечисление

Заголовок Accept.

Значение	Описание
application/json;odata.metadata=none

AutocompleteItem

Объект

Результат запросов автозавершения.

Имя	Тип	Описание
queryPlusText	string	Запрос вместе с завершенным термином.
text	string	Завершенный термин.

AutocompleteMode

Перечисление

Задает режим автозаполнения. Значение по умолчанию — oneTerm. Используйте 'twoTerms' для получения битумной черепицы и 'oneTermWithContext' для использования текущего контекста при создании автозаполнения терминов.

Значение	Описание
oneTerm	Предлагается только один термин. Если запрос состоит из двух терминов, завершается только последний термин. Например, если входными данными является «вашингтонский медик», предлагаемые термины могут включать «medicaid», «medicare» и «medicine».
twoTerms	Будут предложены соответствующие двухчленные фразы в индексе. Например, если в поле ввода указано «медик», предлагаемые термины могут включать «покрытие медицинской помощи» и «фельдшер».
oneTermWithContext	Завершает последний термин в запросе двумя или более терминами, где последние два термина являются фразой, существующей в индексе. Например, если вводом является «вашингтонский медик», предлагаемые термины могут включать «вашингтон медикейд» и «вашингтон медикал».

AutocompleteRequest

Объект

Параметры для нечеткого сопоставления и других поведения запросов автозаполнения.

Имя	Тип	Описание
autocompleteMode	AutocompleteMode	Задает режим автозаполнения. Значение по умолчанию — oneTerm. Используйте 'twoTerms' для получения битумной черепицы и 'oneTermWithContext' для использования текущего контекста при создании автозаполненных терминов.
filter	string	Выражение OData, которое фильтрует документы, используемые для создания завершенных терминов, для результата автозаполнения.
fuzzy	boolean	Значение, указывающее, следует ли использовать нечеткое сопоставление для запроса автозаполнения. По умолчанию — false. Если задано значение true, запрос будет автоматически заполнять термины, даже если в тексте поиска есть замененный или отсутствующий символ. Хотя в некоторых сценариях это обеспечивает более эффективное взаимодействие, это приводит к снижению производительности, так как нечеткие запросы автозаполнения выполняются медленнее и потребляют больше ресурсов.
highlightPostTag	string	Тег строки, добавляемый для выделения попаданий. Необходимо задать с выделенным значениемPreTag. Если этот параметр опущен, выделение попаданий будет отключено.
highlightPreTag	string	Тег строки, который предопределен для выделения попаданий. Необходимо задать с помощью highlightPostTag. Если этот параметр опущен, выделение попаданий будет отключено.
minimumCoverage	number (double)	Число от 0 до 100, указывающее процент индекса, который должен быть покрыт автозаполнением, чтобы запрос был признан успешным. Этот параметр может быть полезен для обеспечения доступности поиска даже для служб с одной репликой. Значение по умолчанию — 80.
search	string	Текст поиска, на котором будут основываться результаты автозаполнения.
searchFields	string	Разделенный запятыми список имен полей, который следует учитывать при запросе автозаполненных терминов. Целевые поля должны быть включены в указанный подборщик.
suggesterName	string	Имя средства предложения, указанное в коллекции предлагаемых элементов, которые входят в определение индекса.
top	integer (int32)	Количество автоматически заполненных терминов для извлечения. Это значение должно быть в диапазоне от 1 до 100. Значение по умолчанию равно 5.

AutocompleteResult

Объект

Результат запроса автозаполнения.

Имя	Тип	Описание
@search.coverage	number (double)	Значение, указывающее процент индекса, который считался запросом автозаполнения, или значение NULL, если минимальное значениеCoverage не было указано в запросе.
value	AutocompleteItem[]	Список возвращаемых автоматически завершенных элементов.

ErrorAdditionalInfo

Объект

Дополнительные сведения об ошибке управления ресурсами.

Имя	Тип	Описание
info		Дополнительные сведения.
type	string	Дополнительный тип сведений.

ErrorDetail

Объект

Сведения об ошибке.

Имя	Тип	Описание
additionalInfo	ErrorAdditionalInfo[]	Дополнительные сведения об ошибке.
code	string	Код ошибки.
details	ErrorDetail[]	Сведения об ошибке.
message	string	Сообщение об ошибке.
target	string	Целевой объект ошибки.

ErrorResponse

Объект

Распространенный ответ об ошибке для всех API Azure Resource Manager для возврата сведений об ошибке для неудачных операций. (Это также следует формату ответа об ошибках OData.).

Имя	Тип	Описание
error	ErrorDetail	Объект ошибки.