You need to enable JavaScript to run this app. 如何使用Phabricator maniphest.edit API通过beforePHIDs控制工单列插入位置
优惠活动
大模型
产品
解决方案
定价
更多

如何使用Phabricator maniphest.edit API通过beforePHIDs控制工单列插入位置

问题核心成因

你遇到的报错本质是Phabricatormaniphest.edit接口中column类型事务的解析逻辑,与官方文档标注的参数结构存在版本差异,不属于参数排列组合的拼写问题。
当前运行环境对value字段的校验逻辑仍严格要求数组元素为纯PHID字符串:一旦检测到value[0]是包含columnPHID、beforePHIDs字段的关联数组,就会直接触发Expected string, got something else的类型校验报错。

可正常运行的curl调用调整方案

实现带位置控制的列编辑,不需要把位置参数嵌套在value内部,只需要调整参数层级即可,具体调用格式如下:

curl https://5555/api/maniphest.edit \
    -d api.token=api-token \
    -d transactions[0][type]=column \
    -d transactions[0][value][0]=PHID-PCOL-6666 \
    -d transactions[0][beforePHIDs][0]=PHID-TASK-7777 \
    -d objectIdentifier=PHID-TASK-8888

具体调整点:

  • 完全保留无位置版本的基础value传值逻辑:将目标列PHID作为value[0]的纯字符串值传入,不要把columnPHID作为value[0]的子字段嵌套,从根源上避免触发类型校验报错
  • 将beforePHIDs参数从value[0]的嵌套层级上移,放置到与type、value平级的事务顶层属性中,作为同事务的独立配置项传入
  • 如果需要指定多个前置位置参照,可依次通过数组下标追加传入,例如transactions[0][beforePHIDs][1]=PHID-TASK-XXXX

关于问题的属性判定

这确实属于文档与实现不同步的已知系统瑕疵,不是操作不当导致的问题:

  • Phabricator对列事务的参数结构做过多次迭代,文档描述的嵌套结构是后续新版本的设计方向,但多数长期维护的分支(包括wmflabs使用的定制分支)的参数解析逻辑,仍然兼容旧版的平层位置参数格式
  • 上述调整后的传参方式,在对应版本环境中可正常实现“将目标工单移动到指定列、并排在传入的beforePHID对应工单之前”的效果
  • 如果调整后仍触发报错,可优先排查两个基础条件:当前API token对目标列是否具备编辑权限、传入的beforePHID关联工单是否确实归属该目标列

内容的提问来源于stack exchange,提问作者Monte Hurd

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.22 01:06:02