由于API是您与API使用者之间的一种形式，它应该是稳定的、一致的、有良好文档支持的，并经过适当的管理。理想情况下，开发者不应该违反这个形式。然而，考虑到有时候他们需要进行破坏性的更改，实际情况往往并非如此。当发生这种情况时，您需要确保已经采取措施，以确保这种更改不会影响您的API使用者。 版本控制是一种实践，通过创建协作的数据共享和编辑控制，确保您的产品在不升级到最新版本的情况下继续为使用者提供更多选择。版本控制是API设计的一个重要部分。它赋予开发者增强其API的能力，而不会在开发新版本时破坏客户端应用程序。版本控制允许客户端继续使用现有的REST API，并在准备好时仅迁移到或更新其应用程序到最新发布的API版本。 何时进行API版本控制 尽管版本控制的时机高度依赖于API使用者的期望，但在进行破坏性更改时，有必要对API进行升级。可能会出现破坏性更改的情况包括： 重命名字段或资源路径。通常在发布API后为了澄清某些内容而进行此操作。 想要更改有效负载结构，包含诸如将整数更改为浮点数之类的内容。 删除API端点的部分，无论是为了修复不良的HTTP动词选择、不一致的设计还是响应代码。 因此，当开发者发布一个API时，他们需要全程管理和监控。如果上述任一项发生，那可能是一个很好的时机对API进行版本控制，以避免破坏现有API使用者的应用程序。 还有一些非破坏性更改，例如添加新的响应参数或新的端点。虽然这些更改不需要更改主版本号，但在进行更改时，必须跟踪API的次要版本。这将有助于支持可能接收到缓存数据版本或面临其他棘手API问题的客户。 API版本控制的类型 面临服务更新的最大挑战是如何处理API合同的更新。当API发生变化时，客户端可能还没有准备好更新他们的应用程序，这就是版本控制策略变得至关重要的地方。不同的公司可以使用不同的方法对其API进行版本控制，但以下是四种常见的API版本控制方式。 1、URI版本控制 这是最自然、也是最常用的方法。它涉及在URL路径中包含版本号。 https://www.example.com/api/1/products 此策略使用URI路由来确定API的特定版本。由于版本更改了URI，客户端可以缓存资源，这样当有更新时，它将被视为缓存中的新条目。这种方法很简单，但违反了URI应该引用唯一资源的原则。 2、查询参数版本控制 此方法涉及将版本号作为查询参数之一。 https://www.example.com/api/products?version=1 从实施的角度来看，这种版本控制策略也很简单。如果没有指定查询参数，通过这种方法更容易切换到最新版本。 3、自定义头版本控制 这是一种允许开发者通过包含包含版本号的自定义头来对API进行版本控制的技术。 bashCopy code curl -H “Accepts-version: V1.” https://www.example.com/api/products 这种方法与查询和URI版本控制不同，因为它不向URI添加填充内容。 4、内容协商版本控制 通过这种方法，开发者可以对单个资源表示进行版本控制，而不是整个API。这提供了更精细的控制，并在代码库中创建了相当大的足迹。 例如： plaintextCopy code Accept: application/vnd.example.v1+json Accept: application/vnd.example+json;version=1.0 这种方法也不需要实施URI路由规则，这是通过URI路径进行版本控制时引入的。然而，与URI版本化的API相比，这种方法较不易访问。此外，内容协商可能允许您保持干净的URL集，但在某些时候，您将面临为不同版本提供内容的挑战。 想了解更多API吗？来API Hub找你所需 Keyword: api接口
API版本控制 – 什么是API版本控制？
Excel表格技巧—如何删除表格中整列数据的单位
Click:algaecide in pool 本教程适用版本：WPS 365 点击免费使用 我们日常办公使用Excel表格录入数据时，为了让数据清晰明显，会在数值后面添加单位。但为了表格整体美观，我们有时需要删除表格中整列数据的单位，这种情况下，我们该怎么办呢？今天，小编就教各位删除表格中整列数据单位的小技巧，大家一起来学习吧！ 首先，打开需要操作的Excel表格，选中需要删除单位的列： >>免费升级到企业版，赠超大存储空间 然后，按组合键“Ctrl+F”键，在弹出的替换面板中，切换到【替换】页面： >>免费升级到企业版，赠超大存储空间 接着，我们在【查找内容】处输入要删掉的单位“元”，【替换为】处留空，单击【全部替换】： >>免费升级到企业版，赠超大存储空间 这时，表格中会弹出替换成功的提示，我们单击【确认】，并在替换面板中按【关闭】键即可： >>免费升级到企业版，赠超大存储空间 >>免费升级到企业版，赠超大存储空间 我们返回到Excel表格中，就会发现该列的单位已经全部被删除了： >>免费升级到企业版，赠超大存储空间 那么，在Excel表格技巧中，删除表格中整列数据单位的操作方法，是不是非常简单呢，你学会了吗？ Keyword: wps下载
Killa Niclab Flash Watermelon 4mg
Description Killa Niclab Flash Watermelon 4mg – This all white tobaccofree nicotine pouch comes from the killapods family. In slim pouches that fit discreetly under your lip this will give you a breath freshening flavor of Watermelon. FACTS Weight: 24 gram (net) Flavour: Melon Nicotine: 5 mg/g ( 4 mg per pouch) Pouch size: Slim Pouch Weight: 0,8 g Number […]
Dainese D-Explorer 2 Gloves
Keyword: womens swimsuits
Cement Aggregate Batcher Machine/ Concrete Batching Machine Pric
QINGDAO HF INDUSTRY CO.,LTD is the professional manufacturer and exporter for block machine technology. Our factory has three manufacturing bases that cover an area of 500 acresand a plant construction area of 100,000 square meters. We are always developing advanced products to international standards to meet consumer demands. We cooperate with SIEMENS for Motors and PLC intelligent control system, Schneider electrical equipmen and YUKEN for the hydraulic operations to […]
Karseell Collagen Hair Mask: Your Path to Silky, Healthy Hair
Karseell Collagen Hair Mask: The Secret to Revitalized Hair Tired of dull, lifeless hair? Seeking a solution to damaged strands and split ends? Look no further than the Karseell Collagen Hair Mask – a potent blend of nature’s finest ingredients designed to revitalize your locks and bring back their natural shine. This mask is a game-changer for anyone seeking healthier, […]
Man Accused Of Murder In LI Body Parts Case Upholds 'Not Guilty' Plea
BABYLON, NY — Court was adjourned on Wednesday for Jeffrey Mackey, a Long Island man charged with murder for his role in a fatal stabbing that left the victims dismembered and scattered in multiple outdoor locations on Long Island. His new court appearance will take place on Dec. 23, said Mackey’s lawyer Anthony La Pinta, who replaced counsel assigned to […]
Suspicious Item Shuts Down 118 Freeway Ramp
LOS ANGELES, CA — Caltrans discovered a suspicious item at the De Soto Avenue on-ramp to the eastbound Ronald Reagan (118) Freeway in the Porter Ranch area, prompting the California Highway Patrol to shut down the on-ramps Thursday afternoon. Both the CHP and the Los Angeles Police Department are on the scene investigating as of 12:45 p.m., CHP Officer Elizabeth […]
North Shore Teacher Strikes: 'Critical Day' As Pressure Mounts To Reopen Schools
BEVERLY, MA — Two weeks of rallies, rhetoric and righteous indignation among three North Shore teachers’ unions seeking new contracts they believe necessary to help solve the “crisis” in public schools and School Committees arguing that the money simply is not there in municipal budgets to meet the educators’ demands appear to be reaching a tipping point after a state […]
Karseell Argan Oil: The Key to Silky Smooth, Glossy Hair
Click:Unique Birthday Earrings for Best Friend Click:EGP nicotine pouches Discover how Karseell Argan Oil can transform your hair into silky, smooth, and glossy perfection. Learn about the benefits of this premium hair oil. Moroccan Argan Oil for Hair Healing Rated 4.99 out of 5 based on 213 customer ratings (214) $15.99 Buy Now This product has multiple variants. The options […]