Skip to main content

itd-sdk

ncruff EffVer Versioning

SDK для работы с https://xn--d1ah4a.com на python.

Документация: https://itdsdk.qzz.io/docs (wip)

Установка

uv add itd-sdk

или через pip:

pip install itd-sdk

Вход

Сейчас есть 3 способа авторизации в SDK:

  1. Без авторизации. Доступен поиск и хэштэги.
  2. Авторизация через access_token. Доступны все запросы кроме тех, которые связаны с авторизацией. Токен действует 15 минут.
  3. Авторизация через refresh_token. Доступны все запросы. Токен действует 7 дней.

Получение refresh_token

  1. Откройте итд.com в браузере
  2. Откройте DevTools (F12)
  3. Перейдите на вкладку "Network" \ "Сеть"
  4. Обновите страницу
  5. Найдите запрос к /v1/auth/refresh
  6. Скопируйте значение refresh_token из Cookies \ Куки

token

Получение access_token

  1. Откройте итд.com в браузере
  2. Откройте DevTools (F12)
  3. Перейдите на вкладку "Network" \ "Сеть"
  4. Откройте любой запрос (если запросов нету, подождите 1-3сек - итд постоянно посылает запросы на обновление статистики постов)
  5. Скопируйте значение authozation из Request headers \ Заголовки запроса

token

API

from itd import ITDClient, init_client, Me, User, Post, Posts, File, Hashtag, Notifications

init_client() # попросит ввести refresh token в консоли
ITDClient(access='access token') # через access token
ITDClient('refresh token') # одноразовая инициализация (не рекомендуется)

me = Me() # получить себя
me.privacy.update(is_private=True)

user = User('itd_sdk') # получить пользователя
user.follow()

post = Post('725681ba-2aaa-42d8-87fb-490c0f44e162') # получить пост
post.like()
post.add_comment('тест комент 6 7')
Post('02bcbba4-f365-4b98-9291-d0bc1fb36fe4').poll.vote('тест') # голосования в опросах

posts = Posts() # получить посты из ленты
for i, post in enumerate(Posts()):
    post.like() # встроенные защиты, из-за которых рейт-лимит будет получить сложнее + авто ожидание окончания рейт лимита
    if i > 10:
        break

post = user.posts[5] # индексация, авто-получение до нужного значения
post.repost()

file = File.from_path('1.jpg') # загрузка файлов
Post.new('всем привет!', attachments=file) # attachments может быть списком, файлом, или UUID

hashtag = Hashtag('тестапи') # получить данные хэштэга
print(hashtag.posts_count)
hashtag.posts[0].like()

notifications = Notifications() # получить уведы
notifications[30].read()
notifications.read_all()
for notification in notifications.stream(): # SSE уведомлений
    print(notification.type.value)
    break

def on_like(notification):
    print('лайк от', notification.actor.username)
    notifications.stop_stream()
notifications.on_like = on_like
stream = notifications.stream_bg() # background SSE

Весь API - https://itdsdk.qzz.io/docs/

Прочее

Star History

Star History Chart

Metadata

Release files for itd-sdk 2.9.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for itd-sdk 2.9.1
File Size Uploaded
itd_sdk-2.9.1.tar.gz 59.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for itd-sdk 2.9.1
File Interpreter ABI Platform
itd_sdk-2.9.1-py3-none-any.whl Python 3 none any Details

Total release size: 141.3 kB

Release files / itd_sdk-2.9.1.tar.gz

Download URL itd_sdk-2.9.1.tar.gz
Size 59.0 kB
Tags Source
SHA-256 checksum
How to use checksums
d3a811c1be3933fcbb3e4b4507d0d7cb831d2f06392f612e33a125eae535a64d
BLAKE2b-256 checksum
How to use checksums
bac1fb8bf367bf8e8d187f370ccf4952baa0cda3768da0314f21ffcc14448c49
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.17 {"installer":{"name":"uv","version":"0.11.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Linux Mint","version":"22.3","id":"zena","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / itd_sdk-2.9.1-py3-none-any.whl

Download URL itd_sdk-2.9.1-py3-none-any.whl
Size 82.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
302e3367d25c2d747d40d5e1516cd2bd951948a9f83a3539b0d366e2dd557766
BLAKE2b-256 checksum
How to use checksums
20f7dd35d5ea0bce999635a28f4c709f10dbf5dc21a460e92fbf1dea8726d6e7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.17 {"installer":{"name":"uv","version":"0.11.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Linux Mint","version":"22.3","id":"zena","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release history Release notifications | RSS feed

2.10.2

2 release files

2.10.1

2 release files

2.9.2

2 release files

This release

2.9.1 This release

2 release files

2.9.0

2 release files

2.8.2

2 release files

2.8.1

2 release files

2.8.0

2 release files

2.7.1

2 release files

2.7.0

2 release files

2.6.1

2 release files

2.6.0

2 release files

2.5.2

2 release files

2.5.1

2 release files

2.4.4

2 release files

2.4.0

2 release files

2.3.0

2 release files

2.2.0

2 release files

2.1.2

2 release files

2.1.1

2 release files

2.1.0

2 release files

1.8.3

2 release files

1.8.2

2 release files

1.8.1

2 release files

1.8.0

2 release files

1.7.0

2 release files

1.6.0

2 release files

1.5.0

2 release files

1.4.0

2 release files

1.3.0

2 release files

1.2.0

2 release files

1.1.0

2 release files

1.0.1

2 release files

1.0.0

1 release file

0.3.0

1 release file

0.2.0

1 release file

0.1.0

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page