使用 Trello API 在卡片上设置自定义字段值

我正在尝试使用新的自定义字段方法特雷洛 API https://developers.trello.com/v1.0/reference#custom-fields设置卡上自定义字段的值。

我创建了一个自定义字段类型number。当我做一个GET请求自定义字段id，它返回这个自定义字段对象：

{
"id":"5ab13cdb8acaabe576xxxxx",
"idModel":"54ccee71855b401132xxxxx",
"modelType":"board",
"fieldGroup":"837a643fd25acc835affc227xxxxxxxxxxxxxxxxxxxx",
"name":"Test Number Field",
"pos":16384,
"type":"number"
}

然后，当我在 Trello UI 中创建新卡时（但不要在Test Number Field框）然后GET该卡使用customFieldItems=true（如记录的here https://developers.trello.com/v1.0/docs/getting-started-custom-fields#section-get-customfielditem-for-single-card），它返回此卡对象（删除了不相关的字段）：

{
"id": "5ab56e6b62abac194d9xxxxx",
"name": "test1",
"customFieldItems": []
}

请注意，由于我没有在其中输入任何内容Test Number FieldUI 中的框，customFieldItems属性包含一个空数组。

然后如果我输入数字1 in the Test Number FieldUI 中的框和GET再次该卡，它返回此（删除了不相关的字段）：

{
"id": "5ab56e6b62abac194d9xxxxx",
"name": "test1",
"customFieldItems":
    [
        {
        "id": "5ab570c5b43ed17b2dxxxxx",
        "value": {
            "number": "1"
            },
        "idCustomField": "5ab13cdb8acaabe5764xxxxx",
        "idModel": "5ab56e6b62abac194d9xxxxx",
        "modelType": "card"
        }
    ]
}

我希望能够通过 API 设置此自定义字段的值。

当我查看 API 文档时“设置、更新和删除卡上自定义字段的值，” (here https://developers.trello.com/v1.0/reference#customfielditemsid）我插入以下信息：

查询授权

• key: （我们的有效/工作 Trello API 密钥）

• token: （我们的有效/工作 Trello API 令牌）

路径参数

• idCard: （应为其设置/更新自定义字段值的卡的 ID） 5ab56e6b62abac194d9xxxxx

• idCustomField （卡上自定义字段的 ID。）: 5ab570c5b43ed17b2dxxxxx

查询参数

• idCustomField（该项目所属的自定义字段的ID。）：5ab13cdb8acaabe576xxxxx

• modelType （这应该始终是卡片。）: card

• value （包含要为卡的自定义字段值设置的键和值的对象。用于设置值的键应与定义的自定义字段的类型匹配。）: {"number": 2}

当我单击“尝试”时，我收到响应：400 Bad Request "Invalid custom field item value."

我尝试过以下操作：

• 两者切换idCustomField值（令人困惑的是路径参数和查询参数具有相同的名称，这意味着它们应该接受相同的值，但它们有不同的描述，并且描述模糊/令人困惑）。

• 两者都设置idCustomField值相同（对于两个可能的 ID）

• 将值设置为2, {"number": "2"}, {number: 2}, {number: "2"}和更多。

无论我尝试什么，我总是能得到"Invalid custom field item value."无论卡在自定义字段中是否有值，其行为方式都是相同的。

我很确定idCustomField在路径参数被接受时，因为当我更改一个字符时，它会给我这个错误："invalid value for idCustomField".

所以我不知道是否"Invalid custom field item value."指的是查询参数idCustomField* or the value.

我也不知道卡在自定义字段中是否具有现有值是否有影响，但我希望能够设置此自定义字段的值，无论它当前是否在场。

现场示例（使用XMLHttpRequest) on Trello 文档页面 https://developers.trello.com/v1.0/reference#setting-custom-field-values-on-cards是错的。您应该使用下一个示例fetch.

var url = "https://api.trello.com/1/cards/{idCard}/customField/{idCustomField}/item?token={yourToken}&key={yourKey}";
var data = {value: { number: "42" }};
fetch(url, { body: JSON.stringify(data), method: 'PUT', headers: {'content-type': 'application/json'}})
.then((resp) => resp.json())
.then((data) => console.log(JSON.stringify(data, null, 2)))
.catch((err) => console.log(JSON.stringify(err, null, 2)))

这个例子有效。尝试之后，我修改了XMLHttpRequest版本，它也有效。

var data = null;
var xhr = new XMLHttpRequest();
xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

data = {value: { number: "3" }};  //added
var json = JSON.stringify(data);  //added

xhr.open("PUT", 'https://api.trello.com/1/cards/{idCard}/customField/{idCustomField}/item?key={yourkey}&token={yourtoken}');
xhr.setRequestHeader('Content-type','application/json');  //added
xhr.send(json);  //modified

关键是你应该 1) 设置请求Content-type标头至application/json2）通过value通过 JSON 对象主体。

我尝试编辑文档中的实时示例，但这是不可能的。我希望他们能尽快修复它。