Skip to content

Рекомендации

Пять блоков главной страницы: акции, высокий рейтинг, мастера, услуги и салоны. Для мастеров, услуг и салонов доступна кнопка «Все» с независимой курсорной прокруткой. feed_id создаётся случайно, не вычисляется из ID аккаунта и живёт 24 часа. Передавайте его только авторизованному клиенту: сейчас это ключ доступа к сохранённому feed.

Получить пять превью рекомендаций

Request

Без feed_id создаёт новую выдачу из текущей геолокации и предпочтений пользователя. С feed_id повторно открывает её. Каждый блок содержит до 10 карточек; пустой блок присутствует в ответе как []. «Акции» и «Высокий рейтинг» берут услуги из всех root-категорий; остальные блоки — из всех выбранных пользователем root-категорий и до трёх случайных дополнительных, зафиксированных для этого feed. Тело запроса не требуется. Результат находится в data стандартной обёртки ответа. unreadNotificationsCount содержит число непрочитанных уведомлений текущего пользователя.

Security
bearerAuth or jwtCookie
Query
feed_idstring, (uuid)

Идентификатор ранее созданной выдачи. Если не передан или пустой, создаётся новый feed на 24 часа с текущей локацией и категориями пользователя. Не содержит ID аккаунта.

curl -i -X GET \
  'https://felmee.com/api/recommendations/home?feed_id=497f6eca-6276-4993-bfeb-53cbbbba6f08' \
  -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""INVALID_DATE""invalid_body""unauthorized""not_found""slot_unavailable""conflict""BUSINESS_INACTIVE""INSUFFICIENT_FUNDS""REQUISITES_REQUIRED"
dataobject or null(RecommendationHome)required

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

Response
{ "success": true, "message": "Рекомендации главной страницы получены", "codeError": null, "error_code": null, "data": { "feed_id": "550e8400-e29b-41d4-a716-446655440000", "promotions": [], "high_rating": [], "masters": [], "services": [ … ], "salons": [], "unreadNotificationsCount": 12 } }