4月20日星期二下午1:00，我们在亚特兰大数据中心升级了路由器。这应该没有用户可见的影响，但它是我们网络基础设施的核心部分，其替代可能导致错误或无法访问的主机。

我们正在维护和升级我们的硬件以提高可靠性。

在此更改之前，从观众Webhooks的410个响应被视为任何其他错误 - 我们为给定的变化重新检索了三次，并始于对观众的其他变化。现在，将禁用410的Webhook，没有重试，以及对观众的所有未来更改。在您的Webhooks页面上的Webhook条目观众设置将表明它已被禁用。

410表示资源消失，缺席可能是永久性的。正确解释此响应意味着我们的服务器和托管Webhook的服务器上的负载较少。此外，这允许Webhook实现者禁用对其WebHook的调用，而无需使API调用明确执行此操作。

市场营销的APIPHP客户机库没有处理领域和complude_fields.查询参数正确。我们修复了客户端生成中的错误，该错误将处理阵列作为CSV字符串。此更改将影响PHP客户端库的3.0.35版本。

用户在传递一系列字符串中报告的意外行为，我们发现Swagger Codegen实用程序没有解析collectionFormat对于预期的查询参数。

的线此端点需要参数，但以前我们返回通用404错误消息。现在我们将返回400个错误，其中有关请求失败的原因。

用户报告对错误消息混淆;我们应该对验证错误进行更多信息。

我们现在以更明确的方式处理布尔查询参数。对于在文档中定义为布尔类型的查询参数，区分大小写字符串真正的和1将被处理为真正的价值，尺寸不敏感字符串错误的和0会被当作错误的价值。其他值将默认为错误的，如果提供。

对于布尔查询参数的可接受值是什么，我们没有一个明确的声明。

我们添加了类似于的终点将订户添加到工作流电子邮件中客户旅行建设者的端点。这是可用的，依赖于API 3.0起始点/等待。

这经典自动化触发器和终点对我们的客户来说是有价值的，但我们不能使用终点，因为它位于自动化API的一部分。这个新的终端提供了类似的功能，但它可以在客户旅行构建器中使用，它提供了经典自动化中不可用的新功能和功能。

我们升级了支持我们的活动搜索功能的弹性型搜索集群，这将导致显着的稳定性改进。

我们在旧的硬件上运行着一个旧版本的ElasticSearch，而旧的硬件很难跟上我们的负载。通过迁移到新的硬件和几个主要的ElasticSearch版本，我们将把失败的搜索请求减少一半。

我们发表了一MailChimp移动SDK Swift包在Xcode中使用。

在Xcode 11或更新中，Swift包管理器提供了向Xcode添加包依赖关系的本机方法。与CocoApods等第三方经理相比，Swift Package Manager是安装移动SDK的更简单方法。制作mailchimpsdk.可作为SWIFT包可用，使我们能够减少重复的代码并提升可维护性。

我们对授权进行了较小的变化，这将影响少数用户。

营销API支持使用授权标题的授权，使用持有者令牌或基本认证，但是通过在查询参数中包含API键，我们还提供了对GET请求授权的遗留支持。对于为GET请求发送了Authorization头和API键查询参数的情况，我们默认使用查询参数值。

我们切换了默认值，以便使用这两种方法，我们在授权标题中使用该值。对于使用具有相互冲突的方法的少量请求，我们将使用该消息返回HTTP 401：

包含在查询参数中的API键与授权标头不一致。请使用单个方法提供授权。

如果您受到此更改的影响，我们建议删除？apikey =查询参数，并仅在快速入门指南中的例子。

授权标题是我们授权API请求的首选方法。如果我们可以假设授权标题存在任何时间，它会简化我们的系统，这是我们将使用的授权方法。

出于安全考虑，我们删除了大部分未使用的Link Application端点。

我们以前支持帖子/授权 - 应用程序端点，允许您发布应用程序的客户端凭据，并接收与该应用程序相关联的新API令牌。

这将以对用户对用户的方式注册到用户帐户的应用程序，从而提高安全性，我们删除了此功能。

在过去的几个月中，只有少数账户访问了端点，因此大多数API用户不会受到影响。

我们更新了营销和交易PHP SDK为7.2使用的武器版本。此版本的缩略图需要PHP 7，因此SDK版本的用户在2021年1月25日之后，需要使用PHP 7。

我们希望对所使用的库保持最新，即使这可能意味着放弃一些遗留支持。我们在Github项目中听取了大量用户的意见后做出了这个决定;感谢您的贡献和反馈!

以下动词和端点：

• 发布/列表/ {list_id} / preview-段

• 帖子/列表/ {list_id} /成员/ {subscriber_hash} / notes

• 补丁/列表/ {list_id} /成员/ {subscriber_hash} / notes / {note_id}

• 补丁/列表/ {list_id} /兴趣类别/ {utmer_category_id} /兴趣/ {exerf_id}

• 发布/列表/ {list_id} /成员/ {subscriber_hash} /标签

有一个身体参数，没有根据我们的摇摆文件中的要求标记，但API端点需要工作。现在根据需要标记这些参数。

这改变了以下方法的方法签名我们的SDKS.:

• createListmembernote / create_list_member_note.

• Updatelistmembernote / update_list_member_note.

• 预览/ preview_segment.

• updateInterestCategoryInterest / update_interest_category_interest

• Updatelistmembertags / update_list_member_tags.

参数标记错误。这导致了与我们的一些示例代码的混淆，而且实际上也不正确。

我们调整了几个端点以返回一个405方法不允许处理未处理的方法而不是a404没有找到。

我们的API端点在响应给定终点不支持的方法时不一致。提供A.405方法不允许，再加上允许标题指定对端点有效的方法，它应该更容易发现和修复错误的API调用。

从管理员仪表板上载产品图像一直失败。我们修复了文件集合，图像上传服务器和前端代码之间的图像上传管道中的错误。

我们发现上传失败发生在向GridFS写入图像数据的过程结束并抛出时不明确的不正确处理的错误。事件处理程序现在介绍这种情况，允许图像上传完成。

我们提高了性能活动邮件列表端点。

我们意识到我们正在从一个低效的源获取bounce活动。使用更有效的方法获取该信息，该端点现在运行速度快了一个数量级——平均请求时间从6秒增加到200毫秒。

此更改也使此端点更加一致地与Web应用程序中显示的弹跳活动。以前，如果电子邮件服务器在给定的广告系列中为单个收件人返回多个反弹，则该端点将包括最新的，而Web应用程序将显示第一个。就此而言，此端点将以第一次反弹响应。

我们修正了电子商务API如何处理没有选择接收营销邮件的客户的错误(例如，当添加订单通过API）。

当我们通过一些电子商务API调用添加一个客户时，我们首先会错误地将其添加为“订阅”联系人(即使他们没有选择加入)，然后立即将其标记为“事务”联系人。首先将他们标记为“订阅”的行为导致我们错误地给这些联系人一个可选择的时间戳，并触发他们进行任何与注册相关的活动，如经典自动化或客户旅程。

我们修正了一个错误列出对话消息这导致返回所有对话的消息。

11月24日造成了一个错误导致的错误列出对话消息端点返回所有会话的消息，而不是只过滤到提供的会话ID的消息。这个问题在12月2日被解决。

我们提高了性能列表成员活动端点。

我们注意到列表成员活动端点运行的查询多于它。我们进行了一些调整，现在处理了25％的速度。

我们修复了查询参数文档列表模板。

查询模板列表中的创建日期过滤器被错误地记录，我们缺少某些排序选项。

在API响应中，我们将链接返回到相关端点。某些targetSchema和模式指向过时的JSON模式文件的字段。我们更改了这些以引用等效的Swagger定义。

在过去，我们推翻了我们使用JSON架构赞成播放。请注意，虽然我们正在更新一些链接定义，但我们不建议依靠他们 - 我们想在将来调查贬低它们。相反，我们建议使用参考文档或摇摆规范。

我们升级了我们的数据库服务的底层硬件，导致显着的性能改进。

我们观察了与我们旧的数据库硬件有关的性能和偶尔的稳定性问题。通过加倍处理器，内存和网卡速度以及具有较新的NVME固态驱动器的三倍磁盘I / O速度，我们的数据库服务正在加工舒适性。反过来，我们的Web应用程序服务也是更快的处理任务。

我们修复了一个bug发布活动端点关于非RSS广告系列的无效请求正文参数。

我们收到了试图创造非的请求rss.类型竞选活动RSS_OPTS.场地。这些请求正在抛出异常和返回500.向用户的状态代码。我们现在返回一个400状态代码if.RSS_OPTS.是否为非rss.类型运动。

我们关闭了MailChimp API游乐场。

API游乐场让用户探索营销API和它返回的数据。相反，我们建议用户了解并探索他们的新数据API参考文档，其中包括为我们的官方编写的丰富代码片段客户端库。

我们修复了一个错误查询过滤自动化列表的参数。

查询参数过滤器被错误地记录为before_send_time.和自-SEND_TIME.。正确的参数是bets_start_time.和自_Start_time.。

我们删除了未使用的更新自动化端点。

该端点受到了自动化工作流类型可以更新的限制，并且在许多个月里都没有成功地调用该端点。我们决定不使用它，直到我们能够提供一个更有用的方法来更新自动化。

由于我们没有看到此端点的任何使用，因此我们不希望需要任何行动。

我们重写了API内部的大部分。除了轻微的性能波动之外，对API行为几乎没有对API行为产生的影响。

在过去的5-10年里，API的内部已经积累了相当多的拼凑，所以我们重写了其中的一部分，并发现了端点之间行为上的一些差异。在重写过程中，我们了解并解决了许多导致内部摩擦的差异——在此过程中，我们确定了未来将实现的进一步更改，以使api之间的行为更加一致。

我们对Swagger规范做了各种修复以改进文档。

文档中包含的端点除了组织路径层次结构之外没有其他功能。例如:/报告。我们删除了他们，因为他们没有自己用。另外，有一些身体参数包含错误，对于只读的属性，不能作为参数传递

我们更新了我们的摇摆规范使它匹配规格在这方面使用Codegen repo.。

我们使用Swagger Spp从Codegen Repo生成API客户端库。这样做需要调整由我们的内部API定义自动生成的威慑规范，因此Codegen Repo中的规格与我们自动产生的规格之间存在一些漂移。我们向后回到了更改，因此我们的自动生成的规范与Codegen Repo中的一个匹配。现在这项工作完成了，我们可以依赖于自动生成的客户端库的规范。

我们已经停止计算（已弃用）现存的,选项,进口字段的经济增长历史端点，API响应将为这些字段具有零的值。

这些字段中的数据可以在其他字段中以更容易理解的方式访问，并且在请求这些端点时，返回这些字段中的数据会很慢，还会增加基础设施负载。

我们发布了API客户端库对于营销和事务API，支持PHP，Node.js，Ruby和Python。

我们希望开发人员能够更容易地将他们的应用程序与我们的两个188金宝慱亚洲体育真人api以他们选择的语言集成。生成的新库公开可用API规范并针对每种支持的语言在各自的包管理器上发布。

当使用相同的电子邮件时，可以强制向一个成员发送多个确认邮件补丁或放请求成员资源。我们通过防止从发送重复的确认电子邮件来纠正此行为。

在此更改之前，将发送到会员收件箱中的多个确认电子邮件，可能会用于滥用。

安全团队在我们的OAuth 2实现中实现了更严格的重定向URL匹配规则。我们现在只支持对重定向URI的精确匹配，以符合OAuth 2规范。

在此更改之前，我们的重定向URL匹配不会符合OAuth 2规范。严格遵守规范导致更可预测的行为和令人惊讶的惊喜。

bin / package-link和箱/包装 - 取消链接是两个新脚本，可自动执行使用本地包所需的所有步骤并处理其依赖项：您不再需要NPM链接包裹或调整你的docker-compose.yml.文件。

以前，为了测试你自己的插件(包括分叉插件)，你必须使用NPM和它的注册表——即使你只是想加载一个本地包。这些脚本极大地简化了包开发，使您能够轻松有效地测试本地插件。

我们改变了退订合并标签的行为，以混淆点击链接的人的电子邮件地址。而不是显示整个地址md_email.参数现在将地址显示为x60.n.@x***。

以前，如果客户点击了退订链接，他们的电子邮件地址就会显示在退订页面上。通过模糊电子邮件地址，这种更改提供了更好的安全性。

API核心现在是自己的插件，提供了yrertapicore.类。你可以用它来构建一个兼容Open Commerce平台的NodeJS微服务，或者你可以在它上构建你的主要Open Commerce API，如果你不想分叉/反应项目。

/反应现在是一个shell项目，它导入了所有必需的NPM包。

API Core现在为开发人员提供了更多的灵活性——这是一种更广泛的转变，不再把分叉作为使用Open Commerce代码库的主要方式。

以前，如果对象作为电子邮件字段的值传递给帖子中的电子邮件字段列表/会员端点，服务器将返回500错误。现在，我们用明确的错误消息返回400个错误。

我们在日志中看到这些错误多次出现。理想情况下，格式糟糕的请求不应该返回500个错误，当错误确实发生时，我们应该向调用者提供更多的信息。

如果在将其添加到购物车后，我们修复了导致结账失败的错误。

如果有人在物品隐藏时积极购物，他们将无法退房。由于结账失败减少了转换率，因此为用户修复此错误非常重要。

一个新的价钱领域已添加到产品和产品variant类型中，以及价格领域已被弃用。

使用新字段时:

• 产品上的价格可以是范围（基于产品的变体）

• 价格(最低、最高、范围)现在通过API对某些产品进行适当报告。188bet亚洲体育网址

我们希望在包和产品类型之间保持字段的一致性。此外,价钱字段使得GraphQL API匹配应用内置定价功能。

的Updateshop.已扩展突变以支持通过GraphQL API更改更多商店设置，包括：

• 货币

• 基础测量单位

• 语言

• 时区

最初转向GraphQL API时没有包括这些选项;通过变异使它们可用，提高了开发人员的便利性。188金宝慱亚洲体育真人

我们已经更新我们的播放文件做它美洲国家组织2-compliant。我们的API参考文档是从Swagger文件生成的。在此更改之前，我们使用了许多非标准字段名来控制这些文档的格式。我们清理了这些场地，并增加了测试，以防止将来漂移。

我们听到开发人员，符合OAS 2标准的招摇会大大提高营销API的开发人员体验。例如，此更新使得可以在邮递员中直接使用我们的Swagger文件来更容易地对我们的API端点提出请求，除了更好地集成许多其他的oas友好工具。

我们留下了剩下的角色和权限相关代码从Open Commerce API到simple-authorization插入。

以前，开发者必须使用内置的身份验证服务，或者将整个应用分叉，以使用自定义的身份验证服务。这一更改使得将该插件替换为自定义授权服务或实现Auth0等其他选项变得更容易。

以前，估值的条目属性对象传递给事件的端点会导致服务器错误，向客户端返回500。通过这个更改，我们将空属性值视为空字符串。

这种变化让客户提供了更灵活性，它们如何格式化属性参数，它会清除服务器日志。

我们已经发布了3.0版本开放商业API。这是数月来该平台的小型更新和改变的高潮，包括:

• GraphQL API的所有功能，取代流星。

• 新管理员应用程序用于管理Web浏览器的商店。

• 插件现在分发给NPM包。

• 新身份服务管理用户，包括Hydra.与OAuth的集成2。

• 更快的开发启动时间，由公共Docker映像支持。

这些都是破坏性的改变，所以现有的插件需要更新，未来的插件应该构建在3.0平台上。

这些变化将大大提高开发人员和商店管理员的经验：NPM插件简化了开发，允许使用插件而无需分叉整个开放商务项目;去除流星依赖性提高了发展速度;并完成GraphQL API在构建UI插件时提供一致性。