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.0

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.0
File Size Uploaded
itd_sdk-2.9.0.tar.gz 58.1 kB Details

Built distribution (wheel)

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

Total release size: 139.4 kB

Release files / itd_sdk-2.9.0.tar.gz

Download URL itd_sdk-2.9.0.tar.gz
Size 58.1 kB
Tags Source
SHA-256 checksum
How to use checksums
c1fb5f4cda85ae31163817a003ed7a22f989de07eabbf18c7ea5223c42bce8b0
BLAKE2b-256 checksum
How to use checksums
f2550323f7cdeca585f237b4c7bf39d7dc5a249f89da8f67544a05aa275614f6
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.0-py3-none-any.whl

Download URL itd_sdk-2.9.0-py3-none-any.whl
Size 81.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f0e324c6c5bb43b5716689fbb24d978ff70a2a7b2812db992e356e9d1a759006
BLAKE2b-256 checksum
How to use checksums
8d39c53ef4c238eb10a8ae016b5321324614b7ffc76e33fbaad2650d545acccf
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

2.9.1

2 release files

This release

2.9.0 This release

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