Asana API问题：创建任务时添加至项目指定分区失败

问题描述 #

我尝试使用Asana API将任务添加到项目的特定分区，参考了预发布文档中的memberships对象并指定了项目和分区ID，先后使用两种JSON格式调用API，但均返回404错误。同时发现正式文档中无memberships选项，请问操作有误之处？是否必须在创建任务后通过单独API调用将其添加到项目分区？

两种请求格式如下：

第一种JSON格式 #

{
  "projects": [ "121212121" ],
  "memberships": [
      {
         "project": {
           "id": "121212121",
           "gid": "121212121",
           "name": "test"
         },
         "section": {
           "id": "090909090",
           "gid": "090909090",
           "name": "test"
         }
      }
  ]
}

第二种JSON格式 #

{
  "projects": [ "121212121" ],
  "memberships": [{
      "project": "121212121",
      "section" : "090909090"
  }]
}

错误原因分析 #

• 预发布文档中提到的memberships特性尚未正式上线，直接调用正式环境的API会因为接口未开放返回404错误。
• 请求中同时传递了projects和memberships字段，二者存在冲突：memberships本身已经包含了项目关联信息，无需重复指定projects数组。

正确操作方式 #

若使用预发布版本API #

• 确保请求指向预发布环境的API端点，而非正式环境。
• 移除请求体中的projects字段，仅保留memberships，且使用简化格式（直接传入项目和分区的gid字符串即可，无需嵌套对象）。示例请求体：

{
  "name": "测试任务",
  "memberships": [
    {
      "project": "121212121",
      "section": "090909090"
    }
  ]
}

若使用正式版本API #

必须分两步操作：

1. 创建任务并关联项目：调用正式版创建任务API，通过projects字段关联目标项目，但无法直接指定分区。
2. 将任务添加到指定分区：调用专门的「添加任务到分区」API，传入任务ID和目标分区ID完成关联。

内容的提问来源于stack exchange，提问作者D-user