Articles from November 2024

Stack Crystal Bracelets | Rose Quartz & Amethyst

企业平台API治理的力量

如今，当你听到关于API治理的讨论时，大多数讨论都集中在我们认为的API设计治理上，即我们“治理”API的表面积的一致性。这是治理的一个显而易见的起点，因为API设计的不一致性可能会导致下游出现最明显和痛苦的问题。 然而，虽然你需要开始掌握你的企业API设计治理策略，但我们认为，你需要在更广泛的范围内投资于我们所说的“平台API治理”。这意味着不仅要投资于每个单独API的发现、可靠性、一致性、交付和可观察性，还要投资于它们周围的运营。 大多数投资于API治理的客户要么刚刚开始并希望了解他们应该做些什么来塑造治理，要么已经开始投资于API设计治理，并面临在所有团队和API中一致地应用治理的挑战。 如果不能发现团队、API以及跨运营工作的情况，他们就无法有效地在大规模上应用API设计治理。此外，如果不能在大规模上观察和评估整体质量和治理的结果，他们就无法将治理应用到更多的团队上，而只能停留在少数几个团队上。 我们发现，那些在“以API为中心”的旅程中走得更远的组织，正从更广泛的平台角度看待治理，确保API是可发现的、可靠的、设计一致的，并通过明确定义的生命周期进行交付，同时确保沿途的一切都是默认可观察的。 API定义 我们观察到企业组织在API治理方面遇到困难的一个原因是，不仅API本身缺乏发现性，围绕每个API的工件、文档以及其他所有工作也缺乏发现性。你无法治理你找不到的东西，而API及其背后的操作越可见，API治理就越有可能深入人心。 平台API治理的基础是确保发现是您的操作中的默认设置： 工作区：确保每个API都有一个私有、合作伙伴或公共工作区来访问每个API周围的操作。 OpenAPI：确保始终有一个人类和机器可读的API工件可用作每个API的真实来源。 Repository：为每个API建立一个Get储存库，将OpenAPI和集合同步到存储库中，作为生命周期的一部分。 环境：提供开发、试运行生产和其他可手动或自动应用的环境。 文档：要求所有API都有完整和最新的文档来证明什么是可能的。 团队：将每个API背后的团队作为列表提供，提供名称和联系信息供消费者使用。 这是您API治理的基础。每个API都应该具备这些元素，并且当团队建立新API或使现有API达到当前标准时，应该有一个蓝图可供遵循。在这些领域的投资将使API设计和其他API操作方面的治理成为可能。一旦您掌握了这些领域，并意识到每个领域都有自己的API，您就会看到完全新的方法来提升您团队中的API治理工作。 API实例 我们接下来希望将API治理的范围扩展到每个API实例的整体可靠性上。我们希望在所有API上提供一套基准测试。这确保了每个API的业务目的得以实现，同时也确保了它以符合服务水平协议（SLA）的方式执行，并且不会在操作中引入任何漏洞或安全问题。 建立团队能够自信地提供和操作我们应用程序和集成背后可靠API的通用方式至关重要： Contract Testing Collection：生成一个集合，为每个API操作提取JSON模式并验证请求和响应。 性能测试集合：生成测试一个或多个API操作的单个集合，确保它满足最小时间阈值。 安全测试集合：生成应用一组通用安全漏洞测试和第三方API安全服务的单个集合。 从历史上看，API治理的这一维度属于质量、测试和其他运营领域，但将其作为API治理堆栈的一部分来考虑是非常有意义的。 这将可靠性作为治理的一部分，并允许我们使用相同的工件和工具来进行测试，以治理我们的API以及围绕它们的API操作。我们可以测试API的实例、这些API的表面积，以及推动这些API在众所周知的API生命周期中前进的操作和基础设施。 API设计 现在我们来到了人们通常在谈到API治理时会提到的平台治理的一部分——即管理你的API设计。API设计治理是确保你的API表面积的技术细节尽可能一致，无论哪个团队设计并开发了该API。这是我们认为很重要的一个API治理领域。 然而，如果没有在已知工作区中的单一信息源（OpenAPI），这个领域也会变得更加困难。当你想到你可以用各种方式来清理你的API的OpenAPI时，这很快就会变成一个陷阱——所以我们建议从小处着手。 设计治理集合 信息：确保有标题、描述和其他基本信息属性。 版本控制：要求对每个API应用标准的语义或基于日期的版本控制。 操作：确保每个操作都有摘要、描述和ID。 参数：规范参数名称的格式，并且都有说明。 响应：推送一组常见的状态代码、媒体类型和模式响应。 模式：使用JSON…

Continue reading

Google 合作伙伴促销优惠简介

促销优惠功能旨在为符合条件的 Google Ads 帐号提供促销优惠。如果一个帐号符合条件，我们会根据该帐号的支出金额向其发放一笔赠送金额。例如，我们会根据您在 30 天内的支出金额，最多赠送您 100 美元。促销优惠可能因公司的徽章状态和帐号的帐单邮寄地址所在国家/地区而异。 帐号资格 由 Google Ads 经理帐号管理的任何帐号只要符合以下条件，即可获享促销优惠： 促销优惠功能已开启。 该帐号未获享任何其他优惠。 该帐号的帐单邮寄地址所在的国家/地区属于 Google 合作伙伴计划促销优惠涵盖的范围。 该帐号在过去 14 天内首次展示了广告。 请参阅此处列出的完整条款及条件。 如何启用促销优惠功能 要使用促销优惠功能，请按以下步骤操作： 登录到您的 Google Ads 帐号。 点击合作伙伴计划标签，在左上角找到“促销优惠”卡片。 点击查看详情，然后选择开启。 点击保存。 促销优惠功能的工作原理 开启促销优惠功能后，如果符合条件的帐号在过去 14 天内首次展示了广告，系统便会自动发放促销优惠。要查看哪些促销优惠将发放至您的帐号，请点击查看详情。 注意：…

Continue reading