API 基础知识

Last update: Mon Apr 08 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：
Workfront API

创建对象：

Developer

Adobe Workfront API的目标是通过引入通过HTTP运行的REST-ful架构来简化与Workfront的集成。本文档假设您熟悉REST和JSON响应，并介绍了Workfront API采用的方法。

熟悉Workfront架构将有助于了解可用于从Workfront中提取数据以进行集成的数据库关系。

限制和准则

为确保一致的Workfront按需系统性能，每个客户最多有10个并发API线程。沙盒环境也有着相同的限制，允许客户和合作伙伴在将代码发布到生产环境之前准确测试API调用。

对于生产、预览和测试驱动器环境，最终用户请求的最大URI长度为8892字节，因为它们是通过Workfront CDN (Akamai)路由的。此限制仅适用于通过CDN路由的URI。

NOTE

此限制不适用于沙盒环境，因为沙盒环境未通过CDN路由。

免责声明

对API的任何使用都应当在Workfront测试版环境中进行测试，然后再在生产环境中运行。如果任何客户将API用于Workfront有理由认为对按需软件造成负担的流程（即，该流程会对其他客户的软件性能产生重大负面影响），Workfront将保留请求客户停止该流程的权利。如果客户不遵守管理法规且问题仍然存在，Workfront将保留终止该流程的权利。

WORKFRONT API URL

有关将用于调用Workfront API的URL的信息，请参阅 Adobe Workfront API调用的域格式.

REST基础知识

本节简要介绍如何与以下REST原则的Workfront REST API交互：

对象URI

系统中的每个对象都有一个由对象类型和ID组成的唯一URI。以下示例显示描述三个唯一对象的URI：

/attask/api/v15.0/project/4c78821c0000d6fa8d5e52f07a1d54d0
/attask/api/v15.0/task/4c78821c0000d6fa8d5e52f07a1d54d1
/attask/api/v15.0/issue/4c78821c0000d6fa8d5e52f07a1d54d2

对象类型不区分大小写，可以是缩写的ObjCode（如proj）或替代对象名称(project)。

有关有效对象代码的列表，请参见 API资源管理器.

运营

通过将HTTP请求发送到对象的唯一URI来控制对象。要执行的操作由HTTP方法指定。

标准HTTP方法对应于以下操作：

GET — 按ID检索对象、按查询搜索所有对象、运行报告或执行命名查询
POST — 插入新对象
PUT — 编辑现有对象
DELETE — 删除对象

为了解决客户端缺陷或协议长度限制，可以使用方法参数覆盖HTTP行为。例如，可以通过发布以下URI来实现GET操作：

GET/attask/api/v15.0/project？id=4c78...54d0&method=get
GET/attask/api/v15.0/project/4c78...54d0？method=get

响应

每个请求都会以JSON格式获得响应。如果请求成功，响应将具有data属性；如果存在问题，则响应将具有error属性。例如，请求

GET /attask/api/v15.0/proj/4c7c08b20000002de5ca1ebc19edf2d5

返回类似于以下内容的JSON响应：

{
    "data"： [
        {
            "percentComplete"：0，
            "status"： "CUR"，
            “优先级”：2，
            "name"： "Brand New Project"，
            "ID"： "4c7c08b20000002de5ca1ebc19edf2d5" 
        } 
    ] 
}

NOTE

通过浏览器的地址栏执行GET请求时，不必将sessionID包含在请求中。

已围绕PUT、POST和DELETE请求添加了特殊安全性。仅当满足以下条件时，才能执行导致向数据库写入或从中删除的任何请求： sessionID=abc123 包含在URI中。以下示例显示了如何查找DELETE请求：

GET/attask/api/v15.0/project？id=4c78...54d0&method=delete&sessionID=abc123
GET/attask/api/v15.0/project/4c78...54d0？method=delete&sessionID=abc123

身份验证

API对每个请求进行身份验证，以确保客户端有权查看或修改请求的对象。

身份验证是通过传入会话ID执行的，会话ID可通过以下方法之一提供：

请求标头身份验证

首选的身份验证方法是传递包含会话令牌的名为SessionID的请求标头。这有一个优势，就是可以安全抵御跨站点请求伪造(CSRF) 攻击，并且不会出于缓存目的干扰URI。

以下是请求标头的示例：

GET /attask/api/v15.0/project/search
SessionID: abc1234

请求参数身份验证

您可以通过传递名为sessionID的请求参数来进行身份验证，如以下示例所示：

GET /attask/api/v15.0/project/4c78821c0000d6fa8d5e52f07a1d54d0?sessionID=abc1234

基于Cookie的身份验证

该API使用的基于Cookie的身份验证与Web UI用于系统的身份验证相同。其中，如果客户端使用Web UI登录到Workfront，则从同一浏览器中进行的任何AJAX调用都使用相同的身份验证。

NOTE

为了防止CSRF（跨站点请求伪造）攻击的可能性，此身份验证方法仅适用于只读操作。

导航到登录屏幕，但不登录。
将URL更改为/attask/api/v15.0/project/search。
请注意，找不到该页面。
替换单词搜索使用login？username=admin&password=user替换您的用户名和密码 管理员 和*用户
*此会话将作为Cookie存储在浏览器中，无需在每次后续GET请求中重述。
将URL更改回 /attask/api/v15.0/project/search.
请注意提供的响应。

执行PUT、POST和DELETE请求时，必须始终包含登录后提供的sessionID。

GET行为

使用HTTPGET方法检索一个或多个对象并运行报表。

正在检索对象

您可以使用修饰符和过滤器来增强对对象的搜索。

使用对象ID检索对象

如果您知道对象的ID，则可以通过访问对象的唯一URI来检索该对象。例如，请求

GET /attask/api/v15.0/project/4c78821c0000d6fa8d5e52f07a1d54d0

返回类似于以下内容的响应：

{
    "percentComplete"：0，
    "status"： "CUR"，
    “优先级”：2，
    "name"： "Brand New Project"，
    "ID"： "4c7c08b20000002de5ca1ebc19edf2d5" 
}

您可以通过指定id请求参数并提供以逗号分隔的ID列表来检索同一请求中的多个对象，如以下示例所示：

GET /attask/api/v15.0/project?id=4c78...54d0,4c78...54d1

请注意， /attask/api/v15.0/project？id=…请求与 /attask/api/v15.0/project/... 请求。

使用URI检索对象

如果要按ID以外的标准检索对象，则可以搜索URI。

例如，您可以使用以下请求返回系统中所有项目的列表：

GET /attask/api/v15.0/project/search

您可以使用请求参数作为名称 — 值对来指定过滤器。例如，以下示例显示一个可查找所有当前项目的请求：

GET /attask/api/v15.0/project/search?status=CUR

以下请求查找所有尚未完成并且已分配给名为John的用户的任务。

GET /attask/api/v15.0/task/search?percentComplete=100
&percentComplete_Mod=lt &assignedTo:firstName=John

使用搜索修饰符

下表列出了您可以与Workfront API一起使用的一些修饰符。

修饰符

描述

示例

返回处于“已关闭”状态的结果

…status=cls&status_Mod=eq…

返回不处于“已关闭”状态的结果

…status=cls&status_Mod=ne…

gte

返回完成百分比大于或等于50的结果

…percentComplete=50&percentComplete_Mod=gte…

lte

返回完成百分比小于或等于50的结果

…percentComplete=50&percentComplete_Mod=lte…

isnull

返回说明为Null的结果

…description_Mod=isnull…

notnull

返回说明不为Null的结果

…description_Mod=notnull…

包含

返回名称包含“Workfront”的结果

…name=Workfront&name_Mod=contains…

介于

返回其输入日期在过去7天内的结果

…entryDate=$$TODAY-7d&entryDate_Range=$$TODAY&entryDate_Mod=between…

NOTE

搜索请求区分大小写。如果收到错误，请确保 修改(_M) 和 范围(_R) 大小写正确。

使用OR语句

您可以通过添加包含“OR”的参数以及数字来增强搜索，以指示过滤器或一系列过滤器的级别。

OR语句仅返回API调用中符合OR语句筛选条件的记录。 OR语句级别上并不隐含过滤器。

例如，如果要筛选

名称中包含“Planning”或
名为“FixedAssets”且分配给名称包含“Steve”OR的人员的项目组合中的任务
具有名为“最终任务”的父任务的任务

然后，将以下API调用与其多个OR语句一起使用：

GET/attask/api/v15.0/task/search？name=Planning
&name_Mod=contains
或(&O):1:portfolio：name=FixAssets
或(&O):1:portfolio：name_Mod=eq
或(&O):1:assignedTo：name=Steve
或(&O):1:assignedTo：name_Mod=cicontains
或(&O):2:parent：name=最终任务
或(&O):2:parent：name_Mod=eq

使用过滤器参数

为搜索过滤器使用URL参数时存在的一个潜在隐患是，Workfront会先解析某些参数，然后再检查是否存在其他身份验证方法（即，用户名、密码、apiKey、Cookie）。如果发生这种情况，则在调用中不会将参数用作过滤器。

要避免出现此问题，您可以将这些值放入带有JSON格式的过滤器参数中。例如，如果要筛选用户名testuser，而不使用

/attask/api/v15.0/user/search？username=testuser@workfront.com

在筛选器中传递URL参数，如以下示例所示：

/attask/api/v15.0/user/search？filters={"username"："testuser@workfront.com"}

使用映射请求参数

默认情况下，从搜索返回的数据是JSON数组。根据您的用例，将结果作为JSON对象按ID索引可能会更有效。可以使用map请求参数完成此操作。例如，请求

/attask/api/v15.0/task/search？map=true

返回按ID索引的响应，如下所示：

{
    "data"： {
        “4c9a97db0000000f13ee4446b9aead9b”： {
            "percentComplete"：0，
            "status"： "NEW"，
            "name"： "first task"，
            "ID"： "4c9a97db0000000f13ee4446b9aead9b"，
            "taskNumber"：1 
        }，
        “4ca28ba600002024cd49e75bd43cf601”： {
            "percentComplete"：0，
            "status"： "INP：A"，
            "name"： "second task"，
            "ID"： "4ca28ba600002024cd49e75bd43cf601"，
            "taskNumber"：2 
        } 
    } 
}

使用字段请求参数

默认情况下，检索对象仅返回最常用的字段子集。

您可以使用字段请求参数指定返回的特定字段的逗号分隔列表。例如，请求

/attask/api/v15.0/task/search？fields=plannedStartDate，priority

返回类似于以下内容的响应：

{
    “优先级”：2，
    "name"： "first task"，
    "ID"："4c7c08fa0000002ff924e298ee148df4"，
    “plannedStartDate”：“2010-08-30T09:00:00:000-0600” 
}

NOTE

这些字段名称区分大小写。

有关可能的字段引用的列表，请参见 API资源管理器

搜索嵌套对象

可以搜索嵌套对象。默认情况下，返回嵌套对象时只包含名称和ID。例如，要了解所有问题及其所有者，请使用以下请求：

/attask/api/v15.0/issue/search？fields=owner

如果需要更多信息，您可以使用冒号语法请求嵌套字段。例如，以下请求搜索所有问题以及所有者的姓名、ID、职务和电话号码

/attask/api/v15.0/issue/search？fields=owner：title，owner：phoneNumber

并返回以下内容：

{
    "name"： "a important issue"，
    "ID"： "4c78285f00000908ea8cfd66e084939f"，
    "owner"： {
        "title"： "Operations Specialist"，
        “电话号码”：“555-1234”，
        "name"： "Admin User"，
        "ID"： "4c76ed7a0000054c172b2c2d9f7f81c3" 
    } 
}

检索嵌套收藏集

您可以检索嵌套的对象集合。例如，要获取项目及其所有任务，请使用以下请求：

/attask/api/v15.0/project/search？fields=tasks

以下请求获取任务分配：

/attask/api/v15.0/task/search？fields=assignments

搜索多个嵌套字段

默认情况下，仅返回每个任务的名称和ID，但可以使用冒号语法指定其他嵌套字段。要查看相关对象或收藏集的所有可用字段，只需在对象/收藏集引用中附加冒号和星号即可。

/attask/api/v15.0/task/search？fields=assignments：*

检索自定义数据

您可以使用前缀“DE：”检索自定义数据字段。例如，要请求具有名为“CustomText”的参数的项目，请使用以下请求：

/attask/api/v15.0/project/search？fields=DE：CustomText

会返回

{
    "name"： "custom data project"，
    “ID”：“4c9a954f0000001afad0687d7b1b4e43”，
    "DE：CustomText"： "任务b" 
}

您还可以通过请求parameterValues字段来检索对象的所有自定义数据。例如，

/attask/api/v15.0/project/search？fields=parameterValues

返回类似于以下内容的数据：

{
    "name"： "custom data project"，
    “ID”：“4c9a954f0000001afad0687d7b1b4e43”，
    参数值： { 
        "DE：CustomText"： "任务b"， 
        “DE：CustomNumber”：1.4， 
        "DE：CustomCheckBoxes"：["first"， "second"， "third"] 
    } 
}

使用命名查询

某些对象类型具有通常执行的命名搜索，可以通过将查询名称附加到对象类型URI的末尾来提供。例如，以下请求可检索用户当前已分配的工作项（任务和问题）：

/attask/api/v15.0/work/myWork

命名查询支持请求字段参数以检索其他字段。一些命名查询也接受其他过滤器。有关对象中允许的命名查询列表，请参阅[API Explorer](https://experienceleague.adobe.com/docs/workfront/using/adobe-workfront-api/api-general-information/api-explorer.html?lang=zh-Hans)中对象的“操作”选项卡。

使用 `Count`

您可以使用 count 以返回与查询匹配的结果数。当您不需要结果中的数据时，这可能很有用。通过只返回计数，服务器可以更快地处理请求并节省带宽。例如，请求

GET/attask/api/v15.0/project/count？status=CUR

按以下格式返回结果数：

{
    "count"： 3 
}

返回计数的数据传输比返回完整对象的数据传输小得多。语法与search命令相同。

请求报告

您可以执行报表请求，其中只需要一个或多个分组的某些字段的汇总。如以下示例所示，报表语法与SOAP API的语法相同：

GET/attask/api/v15.0/hour/report？project：name_1_GroupBy=true&hours_AggFunc=sum

将返回以下结果

{
    “第一个项目”： { 
        "sum_hours"：15个 
    }， 
     “第二个项目”： { 
        "sum_hours"：30 
    } 
}

添加$$ROLLUP=true参数将包含每个分组级别的总数：

{
    “第一个项目”： { 
        "sum_hours"：15个 
    }， 
    “第二个项目”： { 
        "sum_hours"：30 
    }， 
    "$$ROLLUP"： { 
        "sum_hours"：45个 
    } 
}

在API中对查询结果进行排序

如果将以下内容附加到API调用，则可以按任何字段对结果进行排序：

&entryDate_Sort=asc

例如，如果要按任务计划开始日期排序，请删除entryDate并将其替换为plannedCompletionDate。

这适用于Workfront中的大多数字段。

考虑查询限制

查询对象时，应特别考虑相关对象之间的关系和搜索限制。例如，如下表所示，项目查询最多可返回2,000个项目。这2,000个项目被视为“主要对象”。如果您在项目中查询“任务”字段，则作为集合的“任务”字段将成为主对象“项目”的辅助对象。 “任务”字段的查询可包含项目中的数千个任务。返回的对象（项目和任务）的总数不能超过50,000的最大值。

为确保获得最佳性能，下表显示了对搜索请求的限制。

查询结果

限制

描述

默认结果数

100

如果在查询筛选器中未指定限制（即$$LIMIT），则结果最多可包含100个主对象。
请参阅使用分页响应以获取有关如何覆盖此限制的说明。

最大结果数

2,000

查询筛选器（即$$LIMIT）最多可返回2000个结果。有关更多信息，请参阅“分页响应”。

最大字段深度

在标识要显示的字段时，您最多只能离开被查询的对象4个级别。

最大对象数

50,000

结果集不能包括50000要对象和辅助对象。

最大字段数

1,000,000

当结果集少于50000个对象时，您的结果可能最多包含1,000,000个字段。

批次创建/更新的最大数量

100

最大批次创建或更新限制为100。

使用分页响应 using-paginated-responses

要覆盖“默认结果数”查询限制并允许200个结果，您可以包括 $$LIMIT=200 在查询中筛选，如以下示例所示：

GET/attask/api/v15.0/project/search？$$LIMIT=200

为确保系统中其他租户的可靠性和性能，每个查询允许的最大结果限制为2000个对象。尝试指定更大的限制将导致一个 IllegalArgumentException 错误消息。

因此，我们建议您考虑对大型数据集使用分页响应。要指定应返回的第一个结果，请添加 $$FIRST 筛选。例如，以下请求为查询返回结果201-250：

GET/attask/api/v15.0/project/search？$$FIRST=200&$$LIMIT=50

请注意，在上例中， $$FIRST=200 返回第201个结果。 $$FIRST=0 将返回第一个结果。将$$FIRST值视为返回结果之前要跳过的结果数可能会有所帮助。

要确保结果正确分页，请使用排序参数。这样可按相同顺序返回结果，以便分页不会重复或跳过结果。例如，要使用对象ID进行排序，请使用 ID_Sort=asc.

创建访问规则

您可以创建访问规则以确定谁可以访问对象。以下是您可以设置的访问规则的示例：

要设置项目以便仅与ID为“abc123”的用户共享，请使用以下请求：

GET/attask/api/v15.0/project/123abcxxxxxxxxxxxxxxxxxxxxxx？method=put &updates={ accessRules： [ {accessorID： 'abc123'， accessorObjCode： 'USER'， coreAction： 'VIEW'} ] }

或者，仅与新用户共享并保持现有权限不变：

GET/attask/api/v15.0/project/123abcxxxxxxxxxxxxxxxxxxxxxx/share？method=put&accessorID=abc123&accessorObjCode=USER&coreAction=VIEW

要检索现有的访问规则，请执行以下操作：

GET/attask/api/v15.0/project/123abcxxxxxxxxxxxxxxxxxxxxxxxx？fields=accessRules：*

POST行为

POST插入新对象。语法与PUT相同，但有一些例外。由于新对象尚不存在，因此它没有ID。因此，URI不包括ID。

创建对象

以下是创建新项目的请求示例：

POST/attask/api/v15.0/project？name=新建项目

响应包括新创建的项目及其新ID和任何其他指定字段。

复制对象

某些对象支持被复制。对于这些对象类型，可以通过使用copySourceID参数发布来创建新对象。例如，以下请求复制给定项目并为其提供一个新名称：

POST /attask/api/v15.0/project?copySourceID=4c7...&name=Copied Project

上传文档

您可以通过以下API URL上传文档：

POST/attask/api/v15.0/upload

API要求内容类型是multipart/form-data。文件的参数名称必须是uploadedFile。服务器返回以下JSON数据：

{
    "handle"： "4c7c08fa0000002ff924e298ee148df4"
}

创建Workfront文档时，您可以使用句柄并发布到以下URL：

POST/attask/api/v15.0/document？updates={
    名称：文件名，
    句柄： abc...123，（来自文件上载的句柄）
    docObjCode：项目（或TASK、OPTASK等）
    对象ID：abc...123，
    currentVersion：{version：v1.0，文件名：文件名}
}

PUT行为

PUT用于更新现有对象。

PUT的响应与GET相同。在这两种情况下，服务器都会在更新后返回对象的新状态。所有用于更改对GET请求的响应的规则也可用于PUT，例如指定要返回的其他字段、自定义数据等。

编辑对象

对象的更新始终使用对象的唯一URI通过ID完成。要更新的字段被指定为请求参数。例如，要更改项目的名称，您可以发送类似于以下内容的请求：

PUT/attask/api/v15.0/project/4c7...？name=新项目名称 
PUT/attask/api/v15.0/project？id=4c7...&name=新项目名称

由于更新需要ID，因此如果服务器上不存在该对象，此操作将失败（不插入）。

指定JSON编辑

如以下示例所示，您可以使用更新请求参数指定要使用JSON语法更新的字段：

PUT/attask/api/v15.0/project/4c7...？更新= 
{
     名称：“新项目名称”， 
     状态：“CUR”、 
     ... 
}

进行嵌套更新

某些对象具有可以更新的私有集合。例如，以下示例演示了如何覆盖给定任务的现有分配：

PUT/attask/api/v15.0/task/4c7...？更新= 
{
    指定任务：[ 
        { 
            assignedToID： "2222...54d0， 
            assignmentPercent： 50.0 
        }，{ 
            roleID： "1111...54d0"
        } 
    ] 
}

NOTE

虽然对顶级所做的更新是稀疏的，但对集合或嵌套对象的更新将完全替换现有集合。要在任务上编辑单个分配而不影响对象，请在分配上使用PUT，而不是在任务上使用。

以下示例将项目设为公共技术支持队列。请注意，现有队列属性将被替换。

PUT/attask/api/v15.0/project/4c7...？更新= 
{ 
    queueDef： { 
        isPublic： 1 
    } 
}

使用操作请求参数

除了简单的编辑之外，某些对象还支持可以执行的其他操作。您可以使用操作请求参数指定这些操作。例如，以下请求重新计算给定项目的时间线：

PUT/attask/api/v15.0/project/4c7...？action=calculateTimel

或

PUT/attask/api/v15.0/project/4c7.../calculateTimeline

移动对象

下面演示了将任务从一个项目移动到另一个项目的语法：

PUT/attask/api/v15.0/task/4c7.../move？projectID=5d8...

此处提供了每种操作类型的示例：(??)

PUT/attask/api/v15.0/project/1234/approveApproval

PUT/attask/api/v15.0/project/1234/calculateFinance

PUT/attask/api/v15.0/project/1234/calculateTimeline

PUT/attask/api/v15.0/project/1234/calculateDataExtension

PUT/attask/api/v15.0/project/1234/recallApproval

PUT/attask/api/v15.0/project/1234/rejectApproval

PUT/attask/api/v15.0/task/1234/move

PUT/attask/api/v15.0/workitem/1234/markViewed

只有移动操作需要标识附加属性，以指定要移动工作项的项目。

以下是每种操作类型的示例：

PUT/attask/api/v15.0/project/1234？method=put&updates={accessRules：[{accessorID： 'abc123'， accessorObjCode： 'USER'， coreAction： 'VIEW'}]}

共享对象

以下示例演示了与团队共享项目的语法：

PUT/attask/api/v15.0/project/123abcxxxxxxxxxxxxxxxxxxxxxxxx/share？accessorID=123abcxxxxxxxxxxxxxxxxxxxxxx&accessorObjCode=TEAMOB

在编辑对象时，可以通过执行PUT并发送类似于以下示例的更新来替换对象上的所有访问规则：

PUT/attask/api/v15.0/project/123abcxxxxxxxxxxxxxxxxxxxxxxxx？method=PUT&updates={accessRules：[{accessorID：'123abcxxxxxxxxxxxxxxxxxxxxxxxxxx'，accessorObjCode：'TEAMOB'，coreAction：'VIEW'}]

以下示例显示了将任务从一个项目移动到另一个项目的语法：

PUT/attask/api/v15.0/task/4c7.../move？projectID=5d8...

DELETE行为

DELETE删除对象。在每种情况下，URI都可以包含参数force=true ，以促使服务器删除指定的数据及其依赖项。在以下示例中，通过在URI上执行HTTPDELETE方法删除任务：

DELETE/attask/api/v15.0/task/4c78821c0000d6fa8d5e52f07a1d54d0 
DELETE/attask/api/v15.0/task？id=4c78821c0000d6fa8d5e52f07a1d54d0 
DELETE/attask/api/v15.0/task/4c78821c0000d6fa8d5e52f07a1d54d0？force=true 
DELETE/attask/api/v15.0/task？id=4c78821c0000d6fa8d5e52f07a1d54d0？force=true

批量更新

批量更新语句在单次API调用中同时更新多个对象。批量创建API调用的构建方式与普通更新调用类似，如以下示例所示：

PUT/attask/api/v15.0/proj？updates=[{"name"："Test_Project_1"}，{"name"："Test_Project_2"}]&method=POST&apiKey=123ab-cxxxxxxxxxxxxxxxxxxxxxxxxxxxx

将导致返回类似于以下内容的内容：

数据： [{
    ID： "53ff8d3d003b438b57a8a784df38f6b3"，
    名称：“Test_Project_1”，
    对象代码：“PROJ”、
    percentComplete： 0，
    计划完成日期：“2014-08-28T11:00:00:000-0400”，
    计划开始日期：“2014-08-28T11:00:00:000-0400”，
    优先级：0，
    预计完成日期：“2014-08-28T16:12:00:000-0400”，
    状态：“CUR”
}，
{
    ID： "53ff8d49003b43a2562aa34eea3b6b10"，
    名称：“Test_Project_2”，
    对象代码：“PROJ”、
    percentComplete： 0usi，
    计划完成日期：“2014-08-28T11:00:00:000-0400”，
    计划开始日期：“2014-08-28T11:00:00:000-0400”，
    优先级：0，
    预计完成日期：“2014-08-28T16:12:00:000-0400”，
    状态：“CUR”
}]

您还可以执行与以下内容类似的批量更新：

PUT/attask/api/v15.0/proj？Umethod=PUT&updates=[{"ID"："123abcxxxxxxxxxxxxxxxxxxxxxxxxxx"，"name"："Test_Project_1_ Edit"}，{"ID"："123abcxxxxxxxxxxxxxxxxxxxxxxxxxx"，"name"："Test_Project_2_Edit"}]&apiKey=123abcxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

将导致返回类似于以下内容的内容：

数据： [ {
     ID： "53ff8e15003b461d4560f7f65a440078"，
     名称：“Test_Project_1_Edit”、
     对象代码：“PROJ”、
     percentComplete： 0，
     计划完成日期：“2014-08-28T11:00:00:000-0400”，
     计划开始日期：“2014-08-28T11:00:00:000-0400”，
     优先级：0，
     预计完成日期：“2014-08-28T16:16:00:000-0400”，
     状态：“CUR”
}，
{
    ID： "53ff8e19003b46238a58d303608de502"，
    名称：“Test_Project_2_Edit”、
    对象代码：“PROJ”、
    percentComplete： 0，
    计划完成日期：“2014-08-28T11:00:00:000-0400”，
    计划开始日期：“2014-08-28T11:00:00:000-0400”，
    优先级：0，
    预计完成日期：“2014-08-28T16:16:00:000-0400”，
    状态：“CUR”
}]

如果希望所有操作在同一事务中发生，请将“atomic=true”作为请求参数添加到批处理API调用中。这样，如果有任何操作失败，则所有操作都将回退。

NOTE

原子批处理操作只能返回“success： true”或错误。

recommendation-more-help

5f00cc6b-2202-40d6-bcd0-3ee0c2316b43

API 基础知识

限制和准则

免责声明

WORKFRONT API URL

REST基础知识

对象URI

运营

响应

身份验证

请求标头身份验证

请求参数身份验证

基于Cookie的身份验证

登录

注销

GET行为

正在检索对象

使用对象ID检索对象

使用URI检索对象

使用搜索修饰符

使用OR语句

使用过滤器参数

使用映射请求参数

使用字段请求参数

搜索嵌套对象

检索嵌套收藏集

搜索多个嵌套字段

检索自定义数据

使用命名查询

使用 Count

请求报告

在API中对查询结果进行排序

考虑查询限制

使用分页响应 using-paginated-responses

创建访问规则

POST行为

创建对象

复制对象

上传文档

PUT行为

编辑对象

指定JSON编辑

进行嵌套更新

使用操作请求参数

移动对象

共享对象

DELETE行为

批量更新

使用 `Count`