ITD-API-SDK

Неофициальный TypeScript/JavaScript SDK для платформы итд.com.

Для начала работы читайте Быстрый старт. Если ищете что то конкретное — смотрите разделы ниже.

Сущности API

Раздел	Что там
Посты	получение и создание постов, лента, лайки, репосты, редактирование, закреп, dwell-трекинг просмотров
Комментарии	получение и отправка комментариев, ответы на комментарии, лайки, редактирование, удаление
Пользователи	получение своего и чужого профиля, поиск, подписки, блокировки и приватность
Уведомления	список, прочтение, настройки и стримминг
Опросы	создание и голосование в опросах
Файлы и вложения	загрузка, скачивание, прикрепление к постам/комментариям
Хэштеги и поиск	получение списка хештегов, тренды, поиск, посты по хэштегу
Сессии	список активных устройств, разлогинивание
Жалобы и пины	подача жалоб, пины профиля
Разметка текста	HTML/Markdown форматирование постов и комментариев
Платформа	анонсы, changelog, версии приложений, топ кланов

Как это устроено

Раздел	Что там
Авторизация и токены	получение токенов, TokenStorage, onNeedRefreshToken
Пагинация	общий паттерн ITDList, load(), for await, сентинелы ALL/BATCH
Ошибки	иерархия ошибок, что и когда бросается
Rate limits	стратегии троттлинга, config.retryEnabled
Realtime / уведомления	SSE-транспорт, почему не EventSource
Миграция с Python-версии	если переезжаешь с itd-sdk для Python

Справочник по API

Автоматически сгенерированный референс по всем классам/функциям/типам — API Reference. Полезен, когда нужна точная сигнатура метода, но начинать знакомство с SDK лучше с разделов выше — там есть контекст и примеры, которых в автогенерированном референсе нет.

Примеры

Рабочие сниппеты целиком — Примеры.

ты Claude Code или другой AI-агент?

Прочти CLAUDE.md в корне репозитория — там собраны конвенции проекта, частые ошибки при переносе кода с Python-версии и карта документации под конкретную задачу. Краткая версия того же для агентов без доступа к репозиторию — llms.txt.