使用Trello API创建带纯色封面卡片时封面未生效问题排查

问题核心 #

创建卡片的POST请求中使用嵌套的cover: {"color":"yellow"}无法生效，但更新卡片的PUT请求使用嵌套cover对象可以正常设置封面，这是因为Trello API对创建和更新卡片的封面参数格式要求存在差异。

解决方案 #

创建卡片时，不要使用嵌套的cover JSON对象，而是直接使用扁平的coverColor参数指定纯色封面：

修改后的POST请求数据：

{
    "key": "{{APIKey}}",
    "token": "{{APIToken}}",
    "idBoard": "{{BoardId}}",
    "idList": "{{ListId}}",
    "name": "{{$randomCatchPhraseDescriptor}}",
    "desc": "{{$randomBs}} from Postman",
    "coverColor": "yellow"
}

如果需要同时设置封面亮度（对应UI中的明暗模式），可以额外添加coverBrightness参数：

{
    "key": "{{APIKey}}",
    "token": "{{APIToken}}",
    "idBoard": "{{BoardId}}",
    "idList": "{{ListId}}",
    "name": "{{$randomCatchPhraseDescriptor}}",
    "desc": "{{$randomBs}} from Postman",
    "coverColor": "yellow",
    "coverBrightness": "light"
}

原因说明 #

Trello的POST /1/cards接口（创建卡片）采用扁平化的参数结构配置封面，而PUT /1/cards/{id}接口（更新卡片）则支持嵌套的cover对象结构。这是两个接口在参数设计上的既定差异，并非功能bug。使用coverColor（和可选的coverBrightness）参数完全符合创建卡片接口的规范，可直接生效设置原生纯色封面。

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