如何通过Trello API设置卡片的自定义字段值？

我刚帮朋友搞定过类似的需求，给你一步步捋清楚怎么操作：

首先，你需要调用PUT请求来更新卡片的自定义字段值，对应的API端点是针对特定卡片和自定义字段的item资源。

核心步骤 #

1. 准备必要的参数 #

你得提前备好这些信息：

• 目标卡片的cardId（可以从卡片URL或者GET卡片接口获取）
• 自定义字段的customFieldId（你已经能GET到这个字段对象，里面的id就是）
• 你的Trello API key和token（在Trello开发者后台创建应用就能拿到）

2. 构造PUT请求 #

请求的URL格式如下：

https://api.trello.com/1/cards/{cardId}/customField/{customFieldId}/item?key={yourApiKey}&token={yourApiToken}

请求体必须是JSON格式，因为是number类型的字段，value需要嵌套在number字段下，比如要设置值为100，请求体就是：

{"value": {"number": 100}}

如果要清空这个字段（回到UI里未填写的状态），直接传null即可：

{"value": null}

3. 示例请求（用curl） #

给你一个可直接复用的curl命令，替换掉占位符就行：

curl -X PUT "https://api.trello.com/1/cards/替换成你的cardId/customField/替换成你的customFieldId/item?key=你的API_KEY&token=你的API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"value": {"number": 100}}'

4. 验证结果 #

请求成功后，再用你之前的GET卡片接口（带上customFieldItems=true参数），就能看到customFieldItems数组里已经包含这个字段的最新值了。

常见坑点提醒 #

• 字段类型必须匹配：别给number字段传字符串，比如{"number": "100"}会报错，必须是数字类型
• 请求头要指定Content-Type: application/json，不然Trello解析不了请求体
• 权限要够：确保你的API token有修改该卡片的权限（比如是卡片所在看板的成员，且token包含了write权限）

内容的提问来源于stack exchange，提问作者Employee