Trello API教程：高效为卡片批量添加多个标签

import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;

public class TrelloCardUpdater {

    private static final String TRELLO_API_BASE_URL = "https://api.trello.com/1"; // Trello API基础URL

    /**
     * 构建用于更新Trello卡片标签的URI。
     *
     * @param cardId   目标卡片的ID。
     * @param labelIds 要添加到卡片的标签ID数组。
     * @param key      Trello API密钥。
     * @param token    Trello API令牌。
     * @return 构建完成的URI字符串。
     * @throws IllegalArgumentException 如果卡片ID或标签ID数组为空。
     */
    public String buildUpdateCardLabelsUri(String cardId, String[] labelIds, String key, String token) {
        if (cardId == null || cardId.isEmpty()) {
            throw new IllegalArgumentException("Card ID cannot be null or empty.");
        }
        if (labelIds == null || labelIds.length == 0) {
            // 如果没有标签ID，可以根据业务需求选择抛出异常或返回不带idLabels参数的URI
            // 此处选择返回一个不带标签参数的URI，表示清空标签或不更新标签
            // 如果需要清空所有标签，可以将idLabels设置为空字符串
            System.out.println("Warning: No label IDs provided. Card labels might be cleared or not updated.");
        }

        StringBuilder uri = new StringBuilder();
        uri.append(TRELLO_API_BASE_URL).append("/cards/").append(cardId);
        uri.append("?"); // 开始添加查询参数

        // 添加idLabels参数
        if (labelIds != null && labelIds.length > 0) {
            uri.append("idLabels=");
            for (int i = 0; i < labelIds.length; i++) {
                if (i > 0) {
                    uri.append(",");
                }
                // 对每个标签ID进行URL编码，确保URI的合法性
                uri.append(URLEncoder.encode(labelIds[i], StandardCharsets.UTF_8));
            }
            uri.append("&"); // 如果后面还有参数，需要添加&
        } else {
             // 如果labelIds为空，且你希望清空卡片所有标签，可以这样设置：
             // uri.append("idLabels=&");
             // 否则，不添加idLabels参数意味着不更新标签，或清空（取决于API实现）
        }

        // 添加认证参数，并进行URL编码
        uri.append("key=").append(URLEncoder.encode(key, StandardCharsets.UTF_8));
        uri.append("&token=").append(URLEncoder.encode(token, StandardCharsets.UTF_8));

        return uri.toString();
    }

    public static void main(String[] args) {
        TrelloCardUpdater updater = new TrelloCardUpdater();
        String cardId = "YOUR_CARD_ID"; // 替换为你的Trello卡片ID
        String[] labelsToAdd = {"LABEL_ID_1", "LABEL_ID_2", "LABEL_ID_3"}; // 替换为你要添加的标签ID数组
        String apiKey = "YOUR_API_KEY"; // 替换为你的Trello API Key
        String apiToken = "YOUR_API_TOKEN"; // 替换为你的Trello API Token

        try {
            String fullUri = updater.buildUpdateCardLabelsUri(cardId, labelsToAdd, apiKey, apiToken);
            System.out.println("生成的PUT请求URI: " + fullUri);

            // 在实际应用中，你需要使用HTTP客户端（如OkHttp, Apache HttpClient, Spring WebClient等）
            // 向这个URI发送一个PUT请求。例如：
            /*
            CloseableHttpClient httpClient = HttpClients.createDefault();
            HttpPut httpPut = new HttpPut(fullUri);
            CloseableHttpResponse response = httpClient.execute(httpPut);
            try {
                // 处理响应...
                System.out.println("HTTP Status Code: " + response.getStatusLine().getStatusCode());
                // Optional: Read response body
                // String responseBody = EntityUtils.toString(response.getEntity());
                // System.out.println("Response Body: " + responseBody);
            } finally {
                response.close();
            }
            httpClient.close();
            */
            System.out.println("\n请注意：上述URI仅为构建示例，实际操作需通过HTTP客户端发送PUT请求。");

            // 示例：清空所有标签（将labelIds设为null或空数组）
            System.out.println("\n--- 示例：清空卡片所有标签 ---");
            String clearLabelsUri = updater.buildUpdateCardLabelsUri(cardId, new String[]{}, apiKey, apiToken);
            System.out.println("生成的清空标签URI: " + clearLabelsUri);

        } catch (Exception e) {
            System.err.println("构建URI时发生错误: " + e.getMessage());
            e.printStackTrace();
        }
    }
}