Skip to content

Получить подсказки адресов

Request

Возвращает список адресов с координатами для автозаполнения форм.

Правила поиска:

  • query обязателен
  • query не должен быть пустым
  • query должен быть не длиннее 300 символов
  • limit необязателен, значение по умолчанию 10
  • limit должен быть в диапазоне от 1 до 20

Требования:

  • требуется JWT
Security
bearerAuth or jwtCookie
Query
querystring, [ 1 .. 300 ] characters.*\S.*required

Строка поиска адреса.

Example:query=москва хабар
limitinteger, (int32), [ 1 .. 20 ]

Максимальное количество подсказок. Сервер ограничивает значение диапазоном от 1 до 20.

Default:10
Example:limit=5
curl -i -X GET \
  'https://felmee.com/api/suggestions/address?query=%D0%BC%D0%BE%D1%81%D0%BA%D0%B2%D0%B0%20%D1%85%D0%B0%D0%B1%D0%B0%D1%80&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"
dataobject or null(AddressSuggestionsData)required

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

Response
{
  "success": true,
  "message": "Address suggestions retrieved successfully",
  "codeError": null,
  "error_code": null,
  "data": {
    "items": [ … ]
  }
}