ITD-SDK-js

KO | EN

gitlite — search

#javascript #react #typescript #llm #golang #android #machine-learning #rust #cli #awesome-list #pytorch #mcp #ios #open-source

(★ 9)

неофициальное SDK/API для итд.com

ITD-SDK-js Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ITD-SDK-js

Неофициальная библиотека на Node.js для работы с API сайта [итд.com](http://итд.com). Упрощает написание ботов и скриптов: берет на себя авторизацию, поддержку сессий и предоставляет готовые методы для основных действий.

## Главное

- **Автоматический Refresh Token**: вам не нужно вручную обновлять `accessToken` в коде. SDK сам подхватит новый, если старый протух, используя данные из `.cookies`.
- **34 готовых метода**: от получения статистики постов до проверки подписок и работы с кланами.
- **Минимум зависимостей**: работает на `axios` и `dotenv`.

## Установка

### Через npm (рекомендуется)

```bash
npm install itd-sdk-js
```

### Из исходников

```bash
git clone https://github.com/FriceKa/ITD-SDK-js.git
cd ITD-SDK-js
npm install
```

## Настройка

1. Создайте `.env` в корне проекта на основе `.env.example` (или используйте переменные окружения).
2. Токен: добавьте `ITD_ACCESS_TOKEN` в .env или положите `.cookies` с `refresh_token` — клиент сам подхватит токен из .env или получит через refresh.
3. Для авто-обновления токена создайте файл `.cookies` с Cookie из браузера (обязательно должен быть `refresh_token`).

SDK по умолчанию читает и пишет `.env` и `.cookies` в корне проекта (`process.cwd()`). При обновлении токена изменения сохраняются в ваш проект. При необходимости можно задать `projectRoot` или явные пути в конструкторе — см. [API_REFERENCE.md](API_REFERENCE.md).

## Примеры

### Базовые запросы

JavaScript

```
import { ITDClient } from 'itd-sdk-js';
import dotenv from 'dotenv';

dotenv.config();

const client = new ITDClient();
// Один раз добавьте .cookies (refresh_token) или ITD_ACCESS_TOKEN в .env — дальше всё автоматически

// Получаем профиль и тренды
const myProfile = await client.getMyProfile();
const trending = await client.getTrendingPosts(10);

console.log(`Авторизован как: ${myProfile.username}`);

```

### Статистика и уведомления

JavaScript

```
// Простая проверка непрочитанных
if (await client.hasUnreadNotifications()) {
    const list = await client.getUnreadNotifications(5);
    console.log(list.notifications);
}

// Статистика конкретного поста
const stats = await client.getPostStats('uuid-поста');
console.log(`${stats.likes} лайков, ${stats.views} просмотров`);

```

## Что умеет SDK

Весь список методов разбит по категориям в документации:

- **Посты**: тренды, поиск, создание, удаление, статистика.
- **Пользователи**: профили, счетчики подписок, клановые эмодзи.
- **Комментарии**: получение топов, ответы, проверка наличия.
- **Уведомления**: фильтрация только непрочитанных, отметка о прочтении.

Полное описание каждого метода — в **[API_REFERENCE.md](API_REFERENCE.md)**.

Опционально: для разгрузки запросов по нескольким аккаунтам можно использовать **пул зеркал** — см. раздел «Пул зеркал» в API_REFERENCE и импорт `itd-sdk-js/mirrors`. Обычный режим с одним аккаунтом не меняется.

## Пост на чужой стене (wall post)

```javascript
// Пишем пост на стене другого пользователя (нужен wallRecipientId, SDK получит его сам)
await client.createWallPost('ITD_API', 'Тестовый пост на чужой стене 🦫');
```

## Рекомендации при создании постов

- **createPost** и **createWallPost** при любой ошибке возвращают **`null`** — всегда проверяйте результат.
- Для загрузки файла и создания поста используется таймаут **120 с** по умолчанию (`uploadTimeout` в опциях клиента), чтобы запрос не зависал при 504 или медленной сети.
- При 5xx/429 или «API вернул null» рекомендуется повторять запрос в приложении (ретраи с задержкой). Подробнее — в [API_REFERENCE.md](API_REFERENCE.md).

## Важно

Это неофициальный проект. Если разработчики сайта изменят структуру API или введут новую защиту, методы могут временно перестать работать. Используйте аккуратно и не спамьте запросами.

---

**Документация:** [API_REFERENCE.md](API_REFERENCE.md) | **Примеры кода:** [examples/README.md](examples/README.md)

ITD-SDK-js

ITD-SDK-js Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

ITD-SDK-js

ITD-SDK-js Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README