Интеграция Trello API с сайтом

Интеграция Trello API с сайтом

Trello используется как лёгкий таск-менеджер для небольших команд. Интеграция с сайтом позволяет автоматически создавать карточки из заявок, отображать публичный роадмап из Trello-доски, синхронизировать статусы задач.

Аутентификация

Trello использует API Key + Token:

$apiKey   = config('services.trello.api_key');
$apiToken = config('services.trello.api_token');

// Базовый URL для всех запросов
$base = "https://api.trello.com/1";
$auth = "?key={$apiKey}&token={$apiToken}";

Создание карточки из формы

class TrelloService
{
    public function createCard(string $listId, array $data): array
    {
        $resp = Http::post("https://api.trello.com/1/cards", [
            'idList' => $listId,
            'name'   => $data['subject'],
            'desc'   => "**От:** {$data['email']}\n\n{$data['message']}",
            'pos'    => 'top',
            'key'    => config('services.trello.api_key'),
            'token'  => config('services.trello.api_token'),
        ]);

        $card = $resp->json();

        // Добавляем метку по приоритету
        if ($data['priority'] === 'high') {
            Http::post("https://api.trello.com/1/cards/{$card['id']}/idLabels", [
                'value' => config('services.trello.urgent_label_id'),
                'key'   => config('services.trello.api_key'),
                'token' => config('services.trello.api_token'),
            ]);
        }

        return $card;
    }
}

Публичный роадмап из Trello

async function getRoadmap(boardId: string): Promise<RoadmapColumn[]> {
  const lists = await fetch(
    `https://api.trello.com/1/boards/${boardId}/lists?cards=open&key=${KEY}&token=${TOKEN}`
  ).then(r => r.json());

  return lists
    .filter((list: any) => !list.closed)
    .map((list: any) => ({
      id:    list.id,
      name:  list.name,
      cards: list.cards.map((card: any) => ({
        id:          card.id,
        title:       card.name,
        description: card.desc,
        labels:      card.labels.map((l: any) => l.name),
        url:         card.shortUrl,
      })),
    }));
}

Webhooks

// Создание webhook в Trello (один раз при настройке)
Http::post("https://api.trello.com/1/webhooks", [
    'callbackURL' => route('webhooks.trello'),
    'idModel'     => $boardId,
    'key'         => $apiKey,
    'token'       => $apiToken,
]);

// Обработчик
Route::post('/webhooks/trello', function (Request $request) {
    $action = $request->input('action');
    if ($action['type'] === 'updateCard') {
        $card      = $action['data']['card'];
        $newListId = $action['data']['listAfter']['id'] ?? null;
        if ($newListId) SyncTrelloCardStatus::dispatch($card['id'], $newListId);
    }
    return response('ok');
});

Сроки

Создание карточек из форм + роадмап: 2–3 рабочих дня.