itd-api

Тема

itd-api / ItdAccountsOptions

Interface: ItdAccountsOptions ​

Defined in: accounts.ts:54

Опции конструктора ItdAccounts.

Всё, что понимает ItdClient, кроме auth и deviceId: они у каждого аккаунта свои и задаются в ItdAccounts.addAccount. Остальное достаётся каждому клиенту — источник токена капчи, заданный здесь, работает для всех аккаунтов. Обычный TokenStorage клиента здесь заменён общей опцией ItdAccountsOptions.storage типа MultiTokenStorage; контейнер сам выдаёт каждому клиенту изолированный срез по имени. Общий deviceId особенно вреден — сервер различает по нему записи в списке сессий, и один на всех сложил бы все аккаунты в одну.

Extends ​

Properties ​

autoRefresh? ​

ts
optional autoRefresh?: boolean;

Defined in: session/options.ts:102

Обновлять токен перед истечением и восстанавливать сессию при ответе 401. По умолчанию true.

При false библиотека просто пробросит ItdAuthError, а обновлением вы управляете сами через itd.auth.refresh().

Inherited from ​

ItdClientOptions.autoRefresh

baseUrl? ​

ts
optional baseUrl?: string;

Defined in: core/options.ts:188

Базовый URL API. По умолчанию https://xn--d1ah4a.com.

Укажите здесь адрес своего прокси, если работаете из браузера: CORS для сторонних источников на итд.com, скорее всего, не настроен.

Inherited from ​

RuntimeOptions.baseUrl

captcha? ​

ts
optional captcha?: CaptchaSolverInput;

Defined in: session/options.ts:92

Откуда брать токен капчи, когда сервер её потребует: при входе по паролю, регистрации, запросе письма для сброса пароля и подтверждении QR-входа.

С этой опцией токен можно не передавать в сами методы — клиент получит его сам.

Inherited from ​

ItdClientOptions.captcha

clock? ​

ts
optional clock?: ItdClock;

Defined in: core/options.ts:232

Часы для тайм-аутов, повторов и очередей. Обычно подменяются только в тестах.

Inherited from ​

RuntimeOptions.clock

events? ​

ts
optional events?: object;

Defined in: options.ts:24

Неизменяемые настройки предметных каналов событий клиента.

notifications? ​

ts
optional notifications?: NotificationEventsOptions<NotificationEventContext>;

Настройки канала уведомлений на всё время жизни клиента.

Inherited from ​

ItdClientOptions.events

features? ​

ts
optional features?: readonly AccountFeature<unknown>[];

Defined in: accounts.ts:61

Модули, создаваемые и устанавливаемые отдельно для каждого аккаунта.

fetch? ​

ts
optional fetch?: {
  (input, init?): Promise<Response>;
  (input, init?): Promise<Response>;
};

Defined in: core/options.ts:230

Своя реализация fetch: для Deno, React Native, тестов или прокси.

Call Signature ​

ts
(input, init?): Promise<Response>;

MDN Reference

Parameters ​
input ​

URL | RequestInfo

init? ​

RequestInit

Returns ​

Promise<Response>

Call Signature ​

ts
(input, init?): Promise<Response>;

MDN Reference

Parameters ​
input ​

string | URL | Request

init? ​

RequestInit

Returns ​

Promise<Response>

Inherited from ​

RuntimeOptions.fetch

headers? ​

ts
optional headers?: Record<string, string>;

Defined in: core/options.ts:236

Заголовки, добавляемые ко всем запросам, — например User-Agent для бота.

Inherited from ​

RuntimeOptions.headers

hooks? ​

ts
optional hooks?: ClientHooks;

Defined in: core/options.ts:249

Хуки запросов.

Inherited from ​

RuntimeOptions.hooks

logger? ​

ts
optional logger?: boolean | Logger;

Defined in: core/options.ts:251

Логгер. true — использовать console.

Inherited from ​

RuntimeOptions.logger

mode? ​

ts
optional mode?: RuntimeMode;

Defined in: core/options.ts:234

Как обращаться с cookie. По умолчанию определяется по среде исполнения.

Inherited from ​

RuntimeOptions.mode

plugins? ​

ts
optional plugins?: readonly ClientPlugin[];

Defined in: accounts.ts:59

Плагины, подключаемые каждому аккаунту, в том числе добавленному позже.

rateLimit? ​

ts
optional rateLimit?: false | RateLimitOptions;

Defined in: core/options.ts:225

Ограничение нагрузки. false отключает очередь.

Inherited from ​

RuntimeOptions.rateLimit

rateLimitScope? ​

ts
optional rateLimitScope?: RateLimitScope;

Defined in: accounts.ts:72

Как делить очередь запросов. По умолчанию 'shared' — одна на всех.

Лимиты итд.com считаются по IP, поэтому аккаунты с одного адреса тратят общую квоту. 'account' даёт каждому свою очередь и нужен, когда у аккаунтов разные адреса — например, при своём прокси у каждого.

В режиме 'shared' настройки очереди берутся из общей опции rateLimit; аккаунту разрешён только rateLimit: false, выводящий его из общей очереди.

reloginOnRefreshFailure? ​

ts
optional reloginOnRefreshFailure?: boolean;

Defined in: session/options.ts:108

Пытаться ли войти заново, если обновление токена не удалось.

Работает, только когда в auth переданы email и пароль. По умолчанию true.

Inherited from ​

ItdClientOptions.reloginOnRefreshFailure

retry? ​

ts
optional retry?: false | RetryOptions;

Defined in: core/options.ts:223

Повторные попытки. false отключает их полностью.

Inherited from ​

RuntimeOptions.retry

services? ​

ts
optional services?: Record<string, 
  | string
| Omit<ServiceDefinition, "name">>;

Defined in: core/options.ts:208

Сервисы платформы на отдельных доменах.

Ключ — имя сервиса, значение — базовый URL или определение целиком. Имя встроенного сервиса задаёт его хост; встроен один — status.

auth у встроенного сервиса наследуется, у нового выводится по хосту: токен уходит основному хосту и его поддоменам, остальным — по явному auth: true.

Example ​

ts
const itd = new ItdClient({
  services: {
    status: 'https://my-proxy.example/status',
    pb: { baseUrl: 'https://pbapi.xn--d1ah4a.com', headers: { Referer: 'https://pixel.xn--d1ah4a.com/' } },
  },
});

Inherited from ​

RuntimeOptions.services

shutdownTimeout? ​

ts
optional shutdownTimeout?: number;

Defined in: core/options.ts:221

Сколько close() и dispose() ждут чужой код, мс. По умолчанию 10000.

Ждут обработчиков событийного канала и операций, вошедших в обёртки плагинов. По истечении срока ресурсы всё равно освобождаются, а метод отклоняется ItdStateError с указанием того, что удерживало остановку. 0 снимает ограничение.

Inherited from ​

RuntimeOptions.shutdownTimeout

storage? ​

ts
optional storage?: MultiTokenStorage;

Defined in: accounts.ts:57

Общее хранилище сессий всех аккаунтов. По умолчанию MemoryMultiTokenStorage.

timeout? ​

ts
optional timeout?: number;

Defined in: core/options.ts:213

Таймаут запроса в мс. По умолчанию 30000 — столько же использует сайт итд.com. 0 снимает ограничение.

Inherited from ​

RuntimeOptions.timeout

userAgent? ​

ts
optional userAgent?: string | false;

Defined in: core/options.ts:244

Значение заголовка User-Agent. false — не отправлять его вовсе.

По умолчанию Mozilla/5.0 (compatible; itd-api/<версия>; …): fetch в Node не шлёт User-Agent сам, а сайт стоит за DDoS-Guard, который такие запросы может не пропустить. В браузере опция не действует — там заголовок менять запрещено.

Inherited from ​

RuntimeOptions.userAgent

Документация itd-api

MIT License