Skip to content

Пользователи / Аккаунт

Получить пользователя

user = c.get_user(
    username='itd_sdk'
)

Параметры

username str Required

Username пользователя или "me" для текущего пользователя.

Ошибки

  • NotFound - пользователь не найден.
  • UserBanned - пользователь заблокирован.

Обновить профиль

profile = c.update_profile(
    username='username12345',
    display_name='Имя',
    bio='Био 123',
    banner_id=None
)

Параметры

username str

Новый username.

Warning

При смене username старый освобождается и может быть занят другими пользователями.

display_name str

Новое имя.

bio str

Биография (о себе).

ID баннера (должен быть загружен через upload_file).

Удалить баннер

Для удаления баннера используйте UNSET:

from itd.models.user import UNSET

c.update_profile(banner_id=UNSET)

Ошибки

  • ValidationError - ошибка валидации (например слишком длинное имя).
  • InvalidFileType - баннер может быть только изображением.
  • RequiresVerification - требуется верификация для GIF-баннера.
  • UsernameTaken - username уже занят.

Получить текущего пользователя

user = c.get_me()
Тоже самое, что и c.get_user('me').

Обновить настройки приватности

from itd.models.user import UserPrivacyData
from itd.enums import AccessType

privacy = c.update_privacy_new(
    privacy=UserPrivacyData(
        private=False,
        wall_access=AccessType.EVERYONE,
        likes_visibility=AccessType.EVERYONE,
        show_last_seen=True
    )
)

Параметры

privacy UserPrivacyData Required

Объект с настройками приватности.

Example

from itd.models.user import UserPrivacyData
from itd.enums import AccessType

c.update_privacy_new(UserPrivacyData(
    private=True,
    wall_access=AccessType.NOBODY,
    likes_visibility=AccessType.NOBODY,
    show_last_seen=False
))

Параметры UserPrivacyData

  • private str - Закрыть профиль (Скрыть от неподписчиков).
  • wall_access AccessType - Доступ к стен.
  • likes_visibility AccessType - Видимость лайков.
  • show_last_seen bool - Показывать время последнего посещения.

AccessType

  • NOBODY - никто
  • MUTUAL - взаимные подписки
  • FOLLOWERS - подписчики
  • EVERYONE - все

Подписаться

followers_count = c.follow(
    username='itd_sdk'
)

Параметры

username str Required

Username пользователя.

Ошибки

  • NotFound - пользователь не найден.
  • AlreadyFollowing - вы уже подписаны.
  • CantFollowYourself - нельзя подписаться на самого себя.
  • UserBlocked - вы заблокировали пользователя или он заблокировал вас.

Отписаться

followers_count = c.unfollow(
    username='itd_sdk'
)

Параметры

username str Required

Username пользователя.

Ошибки

  • NotFound - пользователь не найден.

Note

Если вы заблокировали пользователя или он заблокировал вас, при отписке вернется 0 (количество подписчиков после отписки). 

print(c.unfollow('nowkie')) # 0, если вы заблокировали nowkie

Получить подписчиков

followers, pagination = c.get_followers(
    username='itd_sdk',
    limit=30,
    page=1
)

Параметры

username str Required

Username пользователя.

limit int

Лимит подписчиков.

page int

Номер страницы для пагинации.

Example

page = 1
all_followers = []

while True:
    followers, pagination = c.get_followers('itd_sdk', page=page)
    all_followers.extend(followers)

    if not pagination.has_more:
        break
    page += 1

Ошибки

  • NotFound - пользователь не найден.

Note

Если вы заблокировали пользователя или он заблокировал вас, вернется ошибка NotFound.

Получить подписки

following, pagination = c.get_following(
    username='itd_sdk',
    limit=30,
    page=1
)

Параметры

username str Required

Username пользователя.

limit int

Лимит пользователей.

page int

Номер страницы для пагинации.

Ошибки

  • NotFound - пользователь не найден.

Note

Если вы заблокировали пользователя или он заблокировал вас, вернется ошибка NotFound.

Заблокировать пользователя

c.unblock(
    username_or_id='nowkie'
)

Параметры

username | str | UUID Required

Username или UUID пользователя.

Ошибки

  • AlreadyBlocked - пользователь уже заблокирован.
  • NotFound - пользователь не найден.
  • CantBlockYourself - нельзя заблокировать самого себя.

Разблокировать пользователя

c.block(
    username_or_id='nowkie'
)

Параметры

username | str | UUID Required

Username или UUID пользователя.

Ошибки

  • NotBlocked - пользователь итак не заблокирован.
  • NotFound - пользователь не найден.

Получить список заблокированных пользователей

c.get_blocked(
    limit=20,
    page=1
)

Параметры

limit int

Лимит пользователей.

page int

Номер страницы для пагинации.

Удалить аккаунт

c.delete_account()

Danger

У вас будет 30 дней на восстановление аккаунта (см. восстановление аккунта ниже). После этого аккаунт безвозратно удалится.

Ошибки

  • AccountAlreadyDeleted: Аккаунт уже удален.

Восстановить аккаунт

c.restore_account()

Ошибки

  • AccountNotDeleted: Аккаунт итак не удален.

Note

Здесь также должна быть ошибка, что уже слишком поздно, но к сожалению у меня нет дополнительного аккаунта для удаления, чтобы посмотреть как она называется 🫤.