调用Azure DevOps Rest API获取工作项类型布局无输出求助

正确的witRefName取值 #

你之前调用的/workitemtypes接口返回结果里，每个工作项类型的referenceName字段才是{witRefName}的正确值——既不是工作项名称（比如Epic），也不是完整URL。比如Scrum流程中Epic的标准引用名是Microsoft.VSTS.WorkItemTypes.Epic，必须用这个完整的引用名而非"Epic"。

排查与解决步骤 #

• 精准获取引用名：从https://dev.azure.com/{organization}/_apis/work/processdefinitions/{processId}/workitemtypes?api-version=4.1-preview.1的返回数据里，找到目标工作项类型的referenceName字段，直接复制填入布局API的对应位置。
• 检查权限：确认你的访问凭据（个人访问令牌/OAuth令牌）拥有**过程（Process）**的读取权限，至少需要"读取"级别权限。
• 切换API稳定版本：预览版可能存在兼容性问题，建议改用稳定版API，比如7.1，调整后的请求地址：

  https://dev.azure.com/{organization}/_apis/work/processdefinitions/{processId}/workItemTypes/{witRefName}/layout?api-version=7.1
  

• 确认请求方法：该API仅支持GET请求，确保你发送的是GET请求而非其他方法。
• 验证processId有效性：确保{processId}是自定义过程的ID，系统默认过程部分API可能存在访问限制，优先用自定义过程测试。

正确请求示例 #

假设组织名为my-org，processId为12345，从/workitemtypes接口获取到Epic的referenceName是Microsoft.VSTS.WorkItemTypes.Epic，则正确请求地址为：

https://dev.azure.com/my-org/_apis/work/processdefinitions/12345/workItemTypes/Microsoft.VSTS.WorkItemTypes.Epic/layout?api-version=7.1

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