# API 更新日志摘要

以下是品牌、合作伙伴和代理机构 API 的最新更新摘要，包括新功能、主要更改和弃用通知。

<details>

<summary>品牌</summary>

在以下位置查看品牌变更日志： [集成门户](https://integrations.impact.com/impact-brand/changelog) 或通过 [RSS](https://integrations.impact.com/impact-brand/changelog.rss).

| 版本   | 更改                                                                                                                                     | 描述                                                                                                                   |
| ---- | -------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| 13.0 | [新端点：PromoCodeExceptionLists](https://integrations.impact.com/impact-brand/v13.0/changelog/new-endpoint-promocodeexceptionlist)        | 该 `PromoCodeExceptionLists` 端点允许您创建、更新、检索和删除促销代码例外列表。                                                                |
| 13.0 | [作用域令牌](https://integrations.impact.com/impact-brand/v13.0/changelog/v13-scoped-tokens)                                                | impact.com 允许您创建作用域令牌：具有详细、精细权限的 API 凭据，可限制或允许对特定 API 端点的访问。                                                         |
| 13.0 | [迁移到 ReportExport](https://integrations.impact.com/impact-brand/v13.0/changelog/v13-migrate-to-reportexport)                           | 如果您通过 impact.com API 导出大量报表数据，现在是切换到更高效的 `ReportExport` API 端点的时候——尤其是在即将对旧版 `Reports` API 于 2025 年 9 月 1 日施加限制的情况下。 |
| 13.0 | [新端点：Upload](https://integrations.impact.com/impact-brand/v13.0/changelog/v13-new-endpoint-upload)                                     | 新的 `Upload` 端点允许您通过 API 上传目录。                                                                                        |
| 13.0 | [Contracts 端点的更改](https://integrations.impact.com/impact-brand/v13.0/changelog/v13-changes-to-contract-endpoint)                       | 该 `Contracts` API 端点现在包含计划条款。                                                                                        |
| 12.0 | [/Ads 端点的改进](https://integrations.impact.com/impact-brand/v13.0/changelog/v12-filter-ads-by-the-date-of-their-creation-or-last-update) | 我们已增强 `/Ads` 端点，使您能更好地控制如何从 impact.com 检索广告详情。                                                                       |
| 12.0 | [Contracts 端点的更改](https://integrations.impact.com/impact-brand/v13.0/changelog/v12-change-to-contracts-endpoint)                       | 在 2025 年 3 月 05 日， `ZeroPayoutHideReport` 字段已添加到 `/Contracts/<Id>` 品牌端点。                                             |
| 12.0 | [Catalogs 端点的更改](https://integrations.impact.com/impact-brand/v13.0/changelog/changes-to-catalog-endpoints)                            | 在 2024 年 9 月 12 日， `Currency` 和 `ServiceAreas` 字段已添加到 `/Catalogs` 和 `/Catalogs/<CatalogId>` 品牌端点。                    |
| 12.0 | [新端点：LegalEntities](https://integrations.impact.com/impact-brand/v13.0/changelog/new-endpoint-legalentities)                           | 新的 `LegalEntities` 端点允许您检索法律实体信息，包括账单地址和间接税详情，适用于与您的帐户关联的法律实体。                                                       |
| 12.0 | [创建合作伙伴端点的更改](https://integrations.impact.com/impact-brand/v13.0/changelog/changes-to-the-create-a-partner-endpoint)                   | 在 2024 年 8 月 23 日，对 `创建合作伙伴` 端点实施了更改，包括添加 `PhoneNumber` 作为参数并弃用 `PromotionalMethods`.                                |
| 12.0 | [操作及操作更新的更改](https://integrations.impact.com/impact-brand/v13.0/changelog/changes-to-actions-and-action-updates)                       | 在 2024 年 8 月 5 日，实施了更改以确保数据完整性并优化 API 性能，包括查询日期范围限制。                                                                 |
| 11.0 | [确保您的数据始终是最新的！](https://integrations.impact.com/impact-brand/v13.0/changelog/ensure-your-data-is-always-fresh)                         | 已向响应添加了新的头部值，以防止客户端缓存数据并收到不正确或过时的信息。                                                                                 |
| 11.0 | [延迟响应端点](https://integrations.impact.com/impact-brand/v13.0/changelog/deferred-response-endpoint)                                      | 该 `DeferredResponse` 端点可用于创建或重放报表或点击作业。                                                                              |
| 11.0 | [Reports 端点分页的更改](https://integrations.impact.com/impact-brand/v13.0/changelog/changes-to-the-reports-endpoint-pagination)             | 在 2023 年 10 月 2 日之后，对 `/Reports` API 端点发出的任何请求，如果指定的页面大小不是 20,000，将返回恰好 20,000 条记录的页面大小。                             |
| 11.0 | [新端点：导出报表](https://integrations.impact.com/impact-brand/v13.0/changelog/new-endpoint-export-a-report)                                  | 该 `ReportExport` 已添加该端点以安排异步导出报表的作业。                                                                                 |
| 10.0 | [Clicks 端点已被弃用](https://integrations.impact.com/impact-brand/v13.0/changelog/clicks-endpoint-will-soon-be-deprecated)                  | 该 `Clicks` 端点已被弃用并被新的 `Jobs` 和 `ClickExport` 功能所取代。                                                                  |
| 10.0 | [新端点：ClickExport 与 Jobs](https://integrations.impact.com/impact-brand/v13.0/changelog/new-endpoints-clickexport-jobs)                  | 两个新端点， `/ClickExport` 和 `/Jobs/`，已被添加以扩展并简化检索点击数据的能力。                                                                |
| 10.0 | [Catalogs 端点更新](https://integrations.impact.com/impact-brand/v13.0/changelog/catalogs-endpoint-update)                                 | 在 2022 年 3 月 1 日，impact.com 弃用了所有版本为 9 及更早的产品目录 API 端点，要求用户升级到版本 10。                                                 |

</details>

<details>

<summary>合作伙伴</summary>

在以下位置查看合作伙伴变更日志： [集成门户](https://integrations.impact.com/impact-publisher/changelog) 或通过 [RSS](https://integrations.impact.com/impact-publisher/changelog.rss).

| 版本   | 更改                                                                                                                                                                    | 描述                                                                                                                   |
| ---- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| 15.0 | [新端点：创建身份验证会话](https://integrations.impact.com/impact-publisher/reference/create-an-identity-verification-session)                                                    | 该 `IdentityVerification` 端点用于验证您的身份。该端点创建或恢复身份验证会话并返回可用于启动验证流程的 URL。                                                 |
| 15.0 | [新端点：ExceptionLists 与 PromoCodeExceptionLists](https://integrations.impact.com/impact-publisher/v15.0/changelog/new-endpoints-exceptionlists-promocodeexceptionlists) | 新的 `ExceptionLists` 和 `PromoCodeExceptionLists` 端点允许您检索 SKU、类别和促销代码的例外列表及例外列表项。                                      |
| 15.0 | [作用域令牌](https://integrations.impact.com/impact-publisher/v15.0/changelog/v15-scoped-tokens)                                                                           | impact.com 允许您创建作用域令牌：具有详细、精细权限的 API 凭据，可限制或允许对特定 API 端点的访问。                                                         |
| 15.0 | [迁移到 ReportExport](https://integrations.impact.com/impact-publisher/v15.0/changelog/v15-migrate-to-reportexport)                                                      | 如果您通过 impact.com API 导出大量报表数据，现在是切换到更高效的 `ReportExport` API 端点的时候——尤其是在即将对旧版 `Reports` API 于 2025 年 9 月 1 日施加限制的情况下。 |
| 15.0 | [Contracts 端点的更改](https://integrations.impact.com/impact-publisher/v15.0/changelog/v15-change-to-contract-endpoint)                                                   | 该 `Contracts` API 端点现在包含 `计划条款`.                                                                                     |
| 14.0 | [Contracts 端点的更改](https://integrations.impact.com/impact-publisher/v15.0/changelog/v14-change-to-contracts-endpoint)                                                  | 在 2025 年 3 月 05 日， `ZeroPayoutHideReport` 字段已添加到 `/Contracts/<Id>` 和 `/Contracts` 合作伙伴端点。                            |
| 14.0 | [新端点：检索所需的银行字段](https://integrations.impact.com/impact-publisher/v15.0/changelog/new-endpoint-retrieve-required-banking-fields)                                       | 该 `/WithdrawalSettings/RequiredFields` 端点允许您检索指定国家/地区的所需银行字段，以及可选的付款方式。                                              |
| 14.0 | [Catalogs 端点的更改](https://integrations.impact.com/impact-publisher/v15.0/changelog/change-to-catalogs-endpoint)                                                        | 在 2024 年 9 月 16 日， `Currency` 和 `ServiceAreas` 字段已添加到合作伙伴 `Catalogs` 端点。                                             |
| 14.0 | [操作及操作更新的更改](https://integrations.impact.com/impact-publisher/v15.0/changelog/changes-to-actions-and-action-updates)                                                  | 在 2024 年 8 月 5 日，对 `Actions` 和 `ActionUpdates` 查询实施了更改以确保数据完整性并优化 API 性能。                                            |
| 14.0 | [确保您的数据始终是最新的！](https://integrations.impact.com/impact-publisher/v15.0/changelog/ensure-your-data-is-always-fresh)                                                    | 已向响应添加了新的头部值，以防止客户端缓存数据并收到不正确或过时的信息。                                                                                 |
| 14.0 | [新端点：税务文件](https://integrations.impact.com/impact-publisher/v15.0/changelog/new-endpoints-tax-documents)                                                              | 已添加四个新的税务文件端点，允许您检索、创建和列出税务文件。                                                                                       |
| 14.0 | [Reports 端点分页的更改](https://integrations.impact.com/impact-publisher/v15.0/changelog/changes-to-the-reports-endpoint-pagination)                                        | 在 2023 年 10 月 2 日之后，对 `/Reports` API 端点发出的任何请求，如果指定的页面大小不是 20,000，将返回恰好 20,000 条记录的页面大小。                             |
| 12.0 | [新端点：导出报表](https://integrations.impact.com/impact-publisher/v15.0/changelog/new-endpoint-export-a-report)                                                             | 该 `ReportExport` 已添加该端点以安排异步导出报表的作业。                                                                                 |
| 12.0 | [Clicks 端点已被弃用](https://integrations.impact.com/impact-publisher/v15.0/changelog/clicks-endpoint-will-soon-be-deprecated)                                             | 该 `Clicks` 端点已被弃用并被新的 `Jobs` 用于数据提取的功能。                                                                              |
| 12.0 | [新端点：ClickExport 与 Jobs](https://integrations.impact.com/impact-publisher/v15.0/changelog/new-endpoints-clickexport-jobs)                                             | 两个新端点， `/ClickExport` 和 `/Jobs/`，已被添加以扩展并简化检索点击数据的能力。                                                                |
| 12.0 | [Catalogs 端点版本更新](https://integrations.impact.com/impact-publisher/v15.0/changelog/catalogs-endpoint-versions-update)                                                 | 在 2022 年 3 月 1 日，impact.com 弃用了所有版本为 11 及更早的产品目录 API 端点，要求升级到版本 12。                                                  |

</details>

<details>

<summary>代理机构</summary>

在以下位置查看代理机构变更日志： [集成门户](https://integrations.impact.com/impact-agency/changelog) 或通过 [RSS](https://integrations.impact.com/impact-agency/changelog.rss).

| 版本  | 更改                                                                                                                         | 描述                                                                                                                   |
| --- | -------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| 3.0 | [迁移到 ReportExport](https://integrations.impact.com/impact-agency/v3.0/changelog/v3)                                        | 如果您通过 impact.com API 导出大量报表数据，现在是切换到更高效的 `ReportExport` API 端点的时候——尤其是在即将对旧版 `Reports` API 于 2025 年 9 月 1 日施加限制的情况下。 |
| 3.0 | [确保您的数据始终是最新的！](https://integrations.impact.com/impact-agency/v3.0/changelog/ensure-your-data-is-always-fresh)             | 已向响应添加了新的头部值，以防止客户端缓存数据并收到不正确或过时的信息。                                                                                 |
| 3.0 | [Reports 端点分页的更改](https://integrations.impact.com/impact-agency/v3.0/changelog/changes-to-the-reports-endpoint-pagination) | 在 2023 年 10 月 2 日之后，对 `/Reports` API 端点发出的任何请求，如果指定的页面大小不是 20,000，将返回恰好 20,000 条记录的页面大小。                             |
| 2.0 | [新端点：导出报表](https://integrations.impact.com/impact-agency/v3.0/changelog/new-endpoint-export-a-report)                      | 该 `ReportExport` 已添加该端点以安排异步导出报表的作业。                                                                                 |

</details>
