请求协助:编写为DevOps工单添加已有Wiki链接的PATCH请求体(适配REST API及Make.com)
请求协助:编写为DevOps工单添加已有Wiki链接的PATCH请求体(适配REST API及Make.com)
嘿,我刚好之前在Make.com里处理过类似的需求,针对Azure DevOps工单添加Wiki链接的PATCH请求体其实很清晰,我给你拆解一下:
首先要明确,我们用的是Azure DevOps的Work Items Update REST API,Make.com的DevOps模块本质也是调用这个接口,所以请求体的结构是通用的。
基础PATCH请求体示例(添加外部/内部Wiki链接)
[ { "op": "add", "path": "/relations/-", "value": { "rel": "Hyperlink", "url": "https://your-wiki-page-full-url", "attributes": { "name": "项目需求Wiki" } } } ]
关键字段解释
op: 用add表示要给工单新增一个链接关系,如果是替换已有链接可以用replace,但你是添加新的所以用add就好path:/relations/-这个路径表示在工单的「关联链接」列表末尾追加新项,是固定写法value里的细节:rel: 如果是普通外部Wiki链接,用Hyperlink就够;如果是Azure DevOps内部的Wiki页面,可以把这个值改成WikiPage(这样在DevOps工单里会显示为原生的Wiki关联样式)url: 替换成你的实际Wiki页面完整URL,内部Wiki的话格式一般是https://dev.azure.com/{你的组织名}/{项目名}/_wiki/wikis/{Wiki名称}/{页面ID}name: 可选字段,设置后会在工单的链接列表里显示这个自定义名称,方便团队识别
在Make.com里的配置步骤
- 打开你的Make.com场景,添加Azure DevOps的「Update Work Item」动作
- 选择对应的DevOps组织、项目,填写要更新的工单ID
- 找到「Body」配置项,切换到「Raw JSON」模式,把上面的JSON代码粘贴进去
- 把
url和name替换成你实际的内容(也可以用Make.com的变量动态填充,比如从之前的步骤里获取Wiki链接)
额外注意点
- 确保你的Make.com DevOps连接账号有编辑工单的权限,不然会返回权限错误
- 如果需要一次性添加多个Wiki链接,只要在JSON数组里多写几个
add操作对象就行,比如:
[ { "op": "add", "path": "/relations/-", "value": { "rel": "Hyperlink", "url": "https://wiki-url-1", "attributes": { "name": "需求文档Wiki" } } }, { "op": "add", "path": "/relations/-", "value": { "rel": "WikiPage", "url": "https://dev.azure.com/xxx/xxx/_wiki/wikis/xxx/123", "attributes": { "name": "内部技术Wiki" } } } ]
备注:内容来源于stack exchange,提问作者indresh mishra
相关产品推荐
相关产品推荐

