Перейти к основному содержимому

Профиль и настройки

Управляйте профилем, предпочтениями и публичной видимостью через API профиля.

Просмотр профиля

GET /api/v1/users/me

Возвращает полный профиль, включая имя, никнейм, email, язык, тему, URL аватара, реферальный код и балансы кошельков. Требует аутентификации.

Обновление профиля

PUT /api/v1/users/me

Отправляйте только поля, которые хотите изменить:

{
"name": "Jane Doe",
"nickname": "janedoe",
"language": "en",
"theme": "dark",
"profile_hidden": false
}
ПолеТипОписание
namestringОтображаемое имя.
nicknamestringУникальный идентификатор для URL публичного профиля.
languagestringЯзык интерфейса: en (английский) или ru (русский).
themestringТема интерфейса: light или dark.
profile_hiddenbooleanПри true ваш профиль скрыт от других пользователей.

Проверка доступности никнейма

GET /api/v1/users/nickname/available?nickname=janedoe

Возвращает boolean, указывающий, доступен ли никнейм.

Управление аватаром

Загрузка аватара

POST /api/v1/users/me/avatar

Отправьте изображение как multipart-форму. Изображение сохраняется в Cloudflare R2.

Удаление аватара

DELETE /api/v1/users/me/avatar

Публичные профили

Любой пользователь может просмотреть публичный профиль другого (если тот не установил profile_hidden в true):

  • По ID: GET /api/v1/users/{id}
  • По никнейму: GET /api/v1/users/by_nickname/{nickname}

Публичные профили отображают имя, никнейм, аватар и торговую статистику. Конфиденциальная информация (email, данные кошельков) никогда не раскрывается.

Сводка эндпоинтов

МетодЭндпоинтАутентификацияОписание
GET/api/v1/users/meОбязательнаПолучить свой профиль
PUT/api/v1/users/meОбязательнаОбновить поля профиля
POST/api/v1/users/me/avatarОбязательнаЗагрузить аватар
DELETE/api/v1/users/me/avatarОбязательнаУдалить аватар
GET/api/v1/users/nickname/availableОбязательнаПроверить доступность никнейма
GET/api/v1/users/{id}ОпциональнаПрофиль по ID
GET/api/v1/users/by_nickname/{nickname}ОпциональнаПрофиль по никнейму