Trello

接入教程

1. 访问Trello开发者网站注册并创建应用
2. 获取API密钥和令牌进行身份验证
3. 使用REST端点创建看板、列表和卡片
4. 通过Webhook设置实时通知功能
5. 测试API调用并集成到您的应用中

Python 示例：获取用户看板

python

import requests

base_url = 'https://api.trello.com/1'
api_key = 'YOUR_API_KEY'
token = 'YOUR_TOKEN'  # Trello requires both key and token

# Get member's boards
response = requests.get(
    f'{base_url}/members/me/boards',
    params={'key': api_key, 'token': token}
)

if response.status_code == 200:
    boards = response.json()
    for board in boards:
        print(f"Board: {board['name']} (ID: {board['id']})")
else:
    print(f"Error: {response.status_code}")
    print(response.text)

PHP 示例：创建新卡片

php

<?php
$base_url = 'https://api.trello.com/1';
$api_key = 'YOUR_API_KEY';
$token = 'YOUR_TOKEN';

$list_id = 'LIST_ID'; // Replace with actual list ID

$data = [
    'name' => 'New Task',
    'desc' => 'Description of the new task',
    'pos' => 'top',
    'key' => $api_key,
    'token' => $token
];

$ch = curl_init($base_url . '/cards');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));

$response = curl_exec($ch);
$http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($http_code == 200) {
    $card = json_decode($response, true);
    echo "Card created successfully. ID: " . $card['id'];
} else {
    echo "Error: " . $http_code . "\n";
    echo $response;
}
?>

JavaScript 示例：更新卡片信息

javascript

const axios = require('axios');

const baseUrl = 'https://api.trello.com/1';
const apiKey = 'YOUR_API_KEY';
const token = 'YOUR_TOKEN';

async function updateCard(cardId, updates) {
    try {
        const response = await axios.put(
            `${baseUrl}/cards/${cardId}`,
            null,
            {
                params: {
                    ...updates,
                    key: apiKey,
                    token: token
                }
            }
        );
        
        console.log('Card updated successfully:');
        console.log(`Name: ${response.data.name}`);
        console.log(`Description: ${response.data.desc}`);
        return response.data;
    } catch (error) {
        console.error('Error updating card:', error.response?.data || error.message);
        throw error;
    }
}

// Usage example
// updateCard('CARD_ID', { name: 'Updated Task Name', desc: 'Updated description' });

常见问题

Trello API 需要哪些认证信息？

Trello API 需要 API Key 和 Token 两种认证信息。API Key 在 Trello 开发者页面注册应用后获得，Token 需要通过 OAuth 流程或直接生成方式获取。所有 API 请求都需要同时包含这两个参数。

如何获取访问令牌（Token）？

有两种主要方式获取 Token：1) 通过 OAuth 1.0a 授权流程，适用于需要用户授权的第三方应用；2) 在 Trello 开发者页面直接生成 Token，适用于个人使用或开发测试。生成的 Token 会关联到您的账户，请妥善保管。

Trello API 有速率限制吗？

是的，Trello API 有速率限制。免费计划通常限制为每分钟 100 次请求，10 秒内最多 10 次请求。超过限制会收到 429 状态码。建议在应用中实现适当的重试机制和请求间隔控制。