如何在通过 REST API 为 Azure DevOps 服务创建错误时找到发行说明字段的 API 端点

Question

我正在尝试通过 REST 添加错误 API，但找不到发行说明字段的路径。

我查看了字段列表的官方文档，但没有关于发行说明字段的信息 official documentation link

以下可能应该创建将信息插入发行说明的操作，但路径错误

patchDocument.Add(
                new JsonPatchOperation()
                {
                    Operation = Operation.Add,
                    Path = "/fields/Microsoft.VSTS.Common.ReleaseNotes",
                    Value = "1"
                }
            );

是否有任何非官方文档或一些库，我可以在其中查看字段的所有可用 API 端点的列表？

Answer 1

简短回答 - 是的！ - 您在问题中遇到的 link 是 API。但是，该文档是 API 参考 Get Work Item Types 操作，其中仅包含一个示例，对可能获得的示例响应进行建模，而不是整体列表。

在开始之前，我假设 发行说明 是自定义字段，因为我在默认 Work item field index 中看不到它。

要了解此（自定义）字段的 path 可能是什么样子，对类型 bug[= 执行 Get Work Item Types API 会有所帮助33=] 在您的项目范围内，并查看响应。这是我得到的，例如：

其中 "dependsOn" 是我在项目使用的流程中定义的自定义字段。

所以为了创建一个错误，我以以下格式向 Create Work Item API 提供了请求正文：

[
  {
    "op": "add",
    "path": "/fields/System.Title",
    "from": null,
    "value": "Sample Bug"
  },
  {
    "op": "add",
    "path": "/fields/Custom.dependsOn",
    "value": "Auth"
  }
]

瞧，创建了一个错误。希望这对您有所帮助！