Возвращает населённые пункты из собственного справочника ГАР/ФИАС в Meilisearch для автозаполнения форм. Использует ту же выборку и порядок, что и /api/search/places, но возвращает названия, регион, район и координаты без признаков метро и районов.
Правила поиска:
queryобязателен как параметр- если
queryпустой или состоит из пробелов, возвращается пустой список - длина
queryпосле удаления начальных и конечных пробелов должна быть не больше 300 символов limitнеобязателен, значение по умолчанию5limitдолжен быть в диапазоне от1до20- сначала ищутся совпадения по названиям населённых пунктов: город, ПГТ, деревня, село, прочие
- только при нехватке совпадений по имени остаток лимита заполняется населёнными пунктами совпавшего региона с тем же порядком типов
- все совпадения по имени предшествуют региональному добору; дубликаты исключаются по ФИАС GUID
- ошибка поиска по имени возвращает
422 address_suggestions_failed; сбой регионального добора сохраняет успешную часть по имени, в том числе пустую
Требования:
- требуется JWT
Security
bearerAuth or jwtCookie
- https://felmee.comhttps://felmee.com/api/suggestions/cities
- http://localhost:8080http://localhost:8080/api/suggestions/cities
curl -i -X GET \
'https://felmee.com/api/suggestions/cities?query=%D0%BC%D0%BE%D1%81%D0%BA&limit=5' \
-H 'Authorization: Bearer <YOUR_JWT_HERE>'Подсказки городов и населённых пунктов успешно получены
Устаревший camelCase-alias поля error_code; при ошибке оба поля содержат одинаковое значение.
Код ошибки. Для успешных ответов всегда null.
Enum:"INVALID_BODY""INVALID_DATE""invalid_body""unauthorized""not_found""slot_unavailable""conflict""BUSINESS_INACTIVE""INSUFFICIENT_FUNDS""REQUISITES_REQUIRED"
Response
{ "success": true, "message": "City suggestions retrieved successfully", "codeError": null, "error_code": null, "data": { "items": [ … ] } }