API 更新日志摘要

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

品牌

在以下位置查看品牌变更日志： 集成门户 或通过 RSS.

版本	更改	描述
13.0	新端点：PromoCodeExceptionLists	该 PromoCodeExceptionLists 端点允许您创建、更新、检索和删除促销代码例外列表。
13.0	作用域令牌	impact.com 允许您创建作用域令牌：具有详细、精细权限的 API 凭据，可限制或允许对特定 API 端点的访问。
13.0	迁移到 ReportExport	如果您通过 impact.com API 导出大量报表数据，现在是切换到更高效的 ReportExport API 端点的时候——尤其是在即将对旧版 Reports API 于 2025 年 9 月 1 日施加限制的情况下。
13.0	新端点：Upload	新的 Upload 端点允许您通过 API 上传目录。
13.0	Contracts 端点的更改	该 Contracts API 端点现在包含计划条款。
12.0	/Ads 端点的改进	我们已增强 /Ads 端点，使您能更好地控制如何从 impact.com 检索广告详情。
12.0	Contracts 端点的更改	在 2025 年 3 月 05 日， ZeroPayoutHideReport 字段已添加到 /Contracts/<Id> 品牌端点。
12.0	Catalogs 端点的更改	在 2024 年 9 月 12 日， Currency 和 ServiceAreas 字段已添加到 /Catalogs 和 /Catalogs/<CatalogId> 品牌端点。
12.0	新端点：LegalEntities	新的 LegalEntities 端点允许您检索法律实体信息，包括账单地址和间接税详情，适用于与您的帐户关联的法律实体。
12.0	创建合作伙伴端点的更改	在 2024 年 8 月 23 日，对 创建合作伙伴 端点实施了更改，包括添加 PhoneNumber 作为参数并弃用 PromotionalMethods.
12.0	操作及操作更新的更改	在 2024 年 8 月 5 日，实施了更改以确保数据完整性并优化 API 性能，包括查询日期范围限制。
11.0	确保您的数据始终是最新的！	已向响应添加了新的头部值，以防止客户端缓存数据并收到不正确或过时的信息。
11.0	延迟响应端点	该 DeferredResponse 端点可用于创建或重放报表或点击作业。
11.0	Reports 端点分页的更改	在 2023 年 10 月 2 日之后，对 /Reports API 端点发出的任何请求，如果指定的页面大小不是 20,000，将返回恰好 20,000 条记录的页面大小。
11.0	新端点：导出报表	该 ReportExport 已添加该端点以安排异步导出报表的作业。
10.0	Clicks 端点已被弃用	该 Clicks 端点已被弃用并被新的 Jobs 和 ClickExport 功能所取代。
10.0	新端点：ClickExport 与 Jobs	两个新端点， /ClickExport 和 /Jobs/，已被添加以扩展并简化检索点击数据的能力。
10.0	Catalogs 端点更新	在 2022 年 3 月 1 日，impact.com 弃用了所有版本为 9 及更早的产品目录 API 端点，要求用户升级到版本 10。

合作伙伴

在以下位置查看合作伙伴变更日志： 集成门户 或通过 RSS.

版本	更改	描述
15.0	新端点：创建身份验证会话	该 IdentityVerification 端点用于验证您的身份。该端点创建或恢复身份验证会话并返回可用于启动验证流程的 URL。
15.0	新端点：ExceptionLists 与 PromoCodeExceptionLists	新的 ExceptionLists 和 PromoCodeExceptionLists 端点允许您检索 SKU、类别和促销代码的例外列表及例外列表项。
15.0	作用域令牌	impact.com 允许您创建作用域令牌：具有详细、精细权限的 API 凭据，可限制或允许对特定 API 端点的访问。
15.0	迁移到 ReportExport	如果您通过 impact.com API 导出大量报表数据，现在是切换到更高效的 ReportExport API 端点的时候——尤其是在即将对旧版 Reports API 于 2025 年 9 月 1 日施加限制的情况下。
15.0	Contracts 端点的更改	该 Contracts API 端点现在包含 计划条款.
14.0	Contracts 端点的更改	在 2025 年 3 月 05 日， ZeroPayoutHideReport 字段已添加到 /Contracts/<Id> 和 /Contracts 合作伙伴端点。
14.0	新端点：检索所需的银行字段	该 /WithdrawalSettings/RequiredFields 端点允许您检索指定国家/地区的所需银行字段，以及可选的付款方式。
14.0	Catalogs 端点的更改	在 2024 年 9 月 16 日， Currency 和 ServiceAreas 字段已添加到合作伙伴 Catalogs 端点。
14.0	操作及操作更新的更改	在 2024 年 8 月 5 日，对 Actions 和 ActionUpdates 查询实施了更改以确保数据完整性并优化 API 性能。
14.0	确保您的数据始终是最新的！	已向响应添加了新的头部值，以防止客户端缓存数据并收到不正确或过时的信息。
14.0	新端点：税务文件	已添加四个新的税务文件端点，允许您检索、创建和列出税务文件。
14.0	Reports 端点分页的更改	在 2023 年 10 月 2 日之后，对 /Reports API 端点发出的任何请求，如果指定的页面大小不是 20,000，将返回恰好 20,000 条记录的页面大小。
12.0	新端点：导出报表	该 ReportExport 已添加该端点以安排异步导出报表的作业。
12.0	Clicks 端点已被弃用	该 Clicks 端点已被弃用并被新的 Jobs 用于数据提取的功能。
12.0	新端点：ClickExport 与 Jobs	两个新端点， /ClickExport 和 /Jobs/，已被添加以扩展并简化检索点击数据的能力。
12.0	Catalogs 端点版本更新	在 2022 年 3 月 1 日，impact.com 弃用了所有版本为 11 及更早的产品目录 API 端点，要求升级到版本 12。

代理机构

在以下位置查看代理机构变更日志： 集成门户 或通过 RSS.

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