Интеграции

Готовые интеграции добавляют поддержку прокси-серверов и автоматическое получение Turnstile-токенов.

Пакет	Точка подключения
@itd-api/proxy	ItdClientOptions.fetch
@itd-api/turnstile	auth.getTurnstileToken

Браузер и CORS

Основной API итд.com не разрешает прямые запросы с другого origin: в preflight-ответе нет Access-Control-Allow-Origin. Для браузерного приложения укажите в baseUrl адрес собственного серверного прокси:

const itd = new ItdClient({
  baseUrl: 'https://api.example.com/itd',
  auth: token,
});

Токен, cookie и запросы авторизации пойдут на этот адрес, поэтому прокси должен быть под вашим контролем. Ограничение CORS не относится к Node.js, Bun, Deno и React Native. Публичный сервис статуса разрешает запросы из браузера напрямую.

Proxy

Пакет создаёт совместимый fetch, который направляет HTTP/HTTPS-запросы через HTTP, HTTPS или SOCKS5-прокси:

npm install @itd-api/proxy

import { ItdClient } from 'itd-api';
import { proxyFetch } from '@itd-api/proxy';

const fetch = proxyFetch('socks5://user:password@127.0.0.1:1080');
const itd = new ItdClient({ auth: token, fetch });

try {
  console.log(await itd.users.me());
} finally {
  await itd.close();
  await fetch.close();
}

Через этот транспорт идут API-запросы, авторизация, повторы и realtime. Пакет работает в Node, Bun и Deno. В браузере исходящий SOCKS/HTTP-прокси таким способом настроить нельзя.

Запускаемый пример:

ITD_TOKEN=<accessToken> ITD_PROXY=socks5://127.0.0.1:1080 \
  node guides/integrations/examples/proxy.mjs

Turnstile

@itd-api/turnstile получает одноразовый токен капчи и передаёт его механизму входа:

import { createTurnstileSolver } from '@itd-api/turnstile';

const itd = new ItdClient({
  auth: {
    email,
    password,
    getTurnstileToken: createTurnstileSolver(),
  },
});

Установка Playwright, сохранение сессии и запускаемые примеры описаны в руководстве по авторизации.

Связанные разделы

• Конфигурация baseUrl и fetch
• @itd-api/proxy
• @itd-api/turnstile
• Авторизация и сессии