Быстрый старт

trello.js — типобезопасный клиент Trello REST API для Node.js и браузеров. Покрывает все публичные эндпоинты, валидирует каждый ответ через Zod и полностью tree-shakable.

Установка

pnpm add trello.js
# или: npm install trello.js
# или: yarn add trello.js

Требуется Node.js 22+. Пакет только ESM — проект должен быть с "type": "module" (или использовать сборщик).

Получение credentials

Понадобится API key и token от Trello:

1. Зайдите на https://trello.com/power-ups/admin и создайте Power-Up, чтобы получить API key.
2. На той же странице используйте ссылку "manually generate a Token" — получите token, привязанный к вашему аккаунту.

Храните их в переменных окружения, не коммитьте в git.

Первый запрос

import { createTrelloClient } from 'trello.js';

const trello = createTrelloClient({
  apiKey: process.env.TRELLO_KEY!,
  apiToken: process.env.TRELLO_TOKEN!,
});

const me = await trello.members.getMember({ id: 'me' });
console.log(`Привет, ${me.fullName}`);

Это весь "hello world". Если имя напечаталось — всё работает.

Что дальше

• Аутентификация — детали про токены, scope, время жизни
• Tree-Shaking — как держать бандл компактным
• Обработка ошибок — как выглядят ошибки
• Рецепты — типичные сценарии для досок, карточек, поиска, webhooks
• API Reference — каждый метод, сгенерировано из исходников (доступен только на английском)