itd-api-sdk
TypeScript/JavaScript SDK для платформы ИТД (xn--d1ah4a.com). Работает и в браузере (Vite/React), и в Node.js.
Если только начинаешь — иди в Быстрый старт. Если уже настроил клиент и ищешь, как сделать что-то конкретное — смотри разделы ниже.
Сущности API
| Раздел | Что там |
|---|---|
| Посты | получение, создание, ленты, лайки, репосты, редактирование, закреп, dwell-трекинг просмотров |
| Комментарии и ответы | получение, отправка, лайки, редактирование, удаление |
| Пользователи | получение, поиск, подписки, блокировки, приватность, свой профиль (Me) |
| Уведомления | список, прочтение, настройки, живой стрим |
| Опросы | создание, голосование |
| Файлы и вложения | загрузка, скачивание, прикрепление к постам/комментариям |
| Хэштеги и поиск | получение, тренды, поиск, посты по хэштегу |
| Сессии (устройства) | список активных входов, разлогинивание |
| Жалобы и пины | подача жалоб, пины профиля |
| Разметка текста | HTML/Markdown → форматирование постов и комментариев |
| Платформенные данные | баннер-объявление, changelog, версии приложений, топ кланов |
Как это устроено
| Раздел | Что там |
|---|---|
| Авторизация и токены | получение токенов, TokenStorage, onNeedRefreshToken |
| Пагинация | общий паттерн ITDList, load(), for await, сентинелы ALL/BATCH |
| Ошибки | иерархия ошибок, что и когда бросается |
| Rate limits | стратегии троттлинга, config.retryEnabled |
| Realtime / уведомления | SSE-транспорт, почему не EventSource |
| Миграция с Python-версии | если переезжаешь с itd (Python) |
Справочник по API
Автоматически сгенерированный референс по всем классам/функциям/типам — API Reference. Полезен, когда нужна точная сигнатура метода, но начинать знакомство с SDK лучше с разделов выше — там есть контекст и примеры, которых в автогенерированном референсе нет.
Примеры
Рабочие сниппеты целиком — Примеры.