Поиск городов, ПГТ, сёл и деревень

Request

Возвращает подсказки населённых пунктов России и признаки наличия метро и районов в справочниках поиска.

Правила:

query обязателен как параметр
пустой query возвращает пустой список
query должен быть не длиннее 300 символов
limit необязателен, значение по умолчанию 5, диапазон от 1 до 20
лимит последовательно заполняется в порядке: город, ПГТ, село, деревня
для ПГТ, сёл и деревень оба признака всегда равны false

Security

bearerAuth or jwtCookie

Query

querystring, <= 300 charactersrequired

Начало названия города, ПГТ, села или деревни.

Example:query=моск

limitinteger, (int32), [ 1 .. 20 ]

Максимальное количество результатов.

Default:5

Example:limit=5

curl -i -X GET \
  'https://felmee.com/api/search/places?query=%D0%BC%D0%BE%D1%81%D0%BA&limit=5' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Найденные населённые пункты

Bodyapplication/json

codeErrorstring or nullrequired

Устаревший camelCase-alias поля error_code; при ошибке оба поля содержат одинаковое значение.

successbooleanrequired

Флаг успешного выполнения запроса

messagestringrequired

Человекочитаемое описание результата

error_codestring or null(ERROR_CODE)required

Код ошибки. Для успешных ответов всегда null.

Enum:"invalid_body""unauthorized""not_found""conflict""object_modified_by_another_thread""action_too_late""too_many_request""code_is_gone""forbidden""user_blocked"

dataArray of objects or null(PlaceSearchItem)required

Полезная нагрузка. Может быть объектом, массивом или null.

Response

{
  "success": true,
  "message": "Place search completed successfully",
  "codeError": null,
  "error_code": null,
  "data": [
    { … },
    { … }
  ]
}