News

REST、GraphQL 和 gRPC 的自动化风格指南

Posted on

如果你问 100 位开发者关于分号的使用位置,你可能会得到 100 种不同的答案,或者引发一场激烈的争论。为了避免这种情况,大多数团队都会采用样式指南。样式指南不仅帮助团队保持代码风格一致,还能避免新成员因为代码风格问题而受到指责。Linter(代码检查工具)就是一个很好的辅助工具,它不仅能推荐最佳实践,还会指出技术上允许但可能带来隐患的代码。随着 API 描述的日益重要,Linter 在这方面的应用也变得越来越广泛。 例如,JavaScript 开发者常用 eslint,PHP 开发者有 PHP Code Sniffer,而 Ruby 开发者则使用 rubocop。这些 Linter 工具不仅仅检查语法是否正确,还会验证代码是否符合特定的规则集。这些规则集有时由公司内部定义,例如非常流行的 eslint-airbnb 规则集。有时,它们是由行业标准组织制定的,比如 PHP-FIG 制定的 PSR-12 标准,CodeSniffer 就有对应的 PSR-12 规则集。 说到 API 文档,大多数大公司都有自己的“样式指南”或“设计手册”。这些指南通常存放在 Google Docs、wiki 或其他文档管理系统中。 基于文本的风格指南是否很浪费时间? 这些基于文本的文档有一个明显的问题:它们通常冗长、内容简洁却枯燥,开发人员很少会花时间去仔细阅读。即使有开发人员认真通读并记住了所有内容,一旦添加新规则,这些知识也会变得部分过时。要了解最新的规则,开发人员不得不重新从头到尾再读一遍整个文档,这显然是不现实的。 在 API the Docs 上,我听到了 Salesforce 的 Kelsey Lambert 的演讲。他们的风格指南是基于 OpenAPI 描述文档的示例,要求开发人员在特定情况下参考这些文档,了解他们应该使用哪些规范。然而,Salesforce 这家巨头公司拥有 238479347 个 API,每个 API 还维护着 […]

News

REST API接口命名的最佳实践

Posted on

REST API 是整合多个应用程序的强大工具。虽然 REST API 非常有用,但创建和部署它们到生产环境中是一个非常复杂且耗时的过程。如果您正在构建自己的 REST API,您应该熟悉一些命名 REST API 端点的行业最佳实践。对于许多开发人员来说,使用开发平台是一种很好的入门方式。它简化了开发流程并确保您能够立即开始。 以下是我们建议的 REST API 端点遵循的命名约定: REST API 端点应遵循良好的命名实践,以提高可用性、可维护性和可扩展性。 使用名词(最好是复数)来表示资源,与 REST 架构风格保持一致。 避免端点名称中的深度嵌套和不必要的特殊字符。 用连字符分隔单词并使用小写字母以避免混淆。 不要在 URI 中使用文件扩展名。使用 Content-Type 实体标头来表示原始文件类型。 REST API 端点中一致的命名约定可增强可读性、理解力和故障排除,并促进增长和可扩展性。 什么是 REST API 端点? REST API 端点是 Web 服务中通信的基石,充当交互点,其中配置了特定的 URL 以接收 Web 请求。它们允许不同的软件应用程序通过定义它们可以使用的方法和数据格式来相互通信。每个端点都是一个特定的 URL,API 可以在其中访问所需的资源(例如服务器数据),并使用标准 HTTP 方法(包括 GET、POST、PUT 和 DELETE)执行操作。适当地命名这些端点对于可读性、可维护性和易于集成至关重要,从而确保无缝的用户体验。 API 端点命名最佳实践 当有一条清晰、完善的路径可供遵循时,浏览 API […]

News

REST API URI 设计的 7 条规则

Posted on

在讨论 REST API URI 设计规则之前,先快速概述一些相关术语。 URI 概述 REST API 使用统一资源标识符 (URI) 来寻址资源。当前的 URI 设计范围从清晰表达 API 资源模型的优秀案例,到一些难以理解的设计。 Tim Berners-Lee 在其“Web 架构公理”中提到,URI 应被视为不透明的标识符:“唯一可以使用标识符的,就是引用一个对象。当不取消引用时,不应查看 URI 字符串的内容以获取其他信息。”因此,客户端应遵循 Web 的链接范式,将 URI 视为不透明的标识符。 REST API 的设计者应创建能够向潜在客户端开发者传达资源模型的 URI。本文将介绍一组 REST API URI 的设计规则,并探讨如何使用 Keycloak 或客户端证书来保护 REST API 的安全。 在深入规则之前,首先介绍 URI 格式,因为本节讨论的规则与 URI 格式密切相关。根据 RFC 3986,通用 URI 语法如下: URI = 方案“://”权限“/”路径[“?”查询][“#”片段] 规则 #1 URI […]

News

API定义和创建最佳实践

Posted on

API 定义是结构化数据文件,提供有关 API 应该如何工作以及如何组织的关键信息。与为人类可读性而设计的 API 规范不同,这些文件旨在供机器可读。 API 定义通常包括请求格式要求、使用的协议以及端点的命名约定。由于文件本身只是结构化文本并且不能直接执行,因此它们可以使用任何编程语言。 如果使用得当,API 定义可以与现有的开发工具协同工作,以生成人类可读的文档、样板代码和测试用例等工件。请继续阅读,了解有关 API 定义如何工作以及如何将它们无缝集成到开发过程的任何阶段的更多信息。 API 定义:优点和工具 如果您以前没有使用过 API 定义,您可能会想知道为什么要费心——尤其是当创建它们会在开发过程中提前增加一些时间时。本节概述了创建 API 定义的主要好处,并讨论了一些流行的方法。 为什么要创建 API 定义? 创建 API 定义的一个简单原因是,为了与市场上的某些常见平台配合使用,可能有必要这样做。例如,如果您使用来自 Google Cloud、Azure、Apigee 或 Amazon 的 API 网关,则需要先准备好 API 定义,然后您的 API 才能在这些平台上上线。所有这四个平台都支持流行的OpenAPI 规范,我们将很快更深入地讨论该规范。 虽然与行业标准平台的兼容性是采用 API 定义的一个很好的理由,但这远不是唯一的原因。近年来,许多开发团队都采用了设计优先的方法。如果您的团队也在其中,那么 API 定义是理所当然的。它们不仅迫使您考虑 API 的预期设计和功能,而且还可以与许多自动化实现工具配合使用。 API 定义可以帮助完成的一些任务包括自动生成 SDK 和文档,以及用于测试接口的模拟服务器实例。通过这些用例,API 定义可以作为未来文档的参考点。 API 定义的另一个好处是它们可以帮助您相对较早地发现代码中的逻辑错误,特别是当您使用验证工具时。在这个阶段发现的错误比以后遇到的错误更容易纠正。 IBM 的一项研究表明,产品发布后发现的错误的修复成本是设计过程中发现的错误的四到五倍。 API 定义的一个不太明显但同样重要的好处是确保不同团队之间的设计方法保持一致。为现有代码添加 […]

News

Lynx Fizzy Lemonade

Posted on

Description Lynx Fizzy Lemonade – This is a 100% tobacco free snus with slim pouches that will fit perfectly under your lip! It has a soft taste of Citrus lemonade, a mix of fresh and sweet in a perfect combination. A favorite throughout the day. Weight: 15 g Flavour: Citrus Nicotine level: 14 mg/g ( […]

News

没有杜兰特的勇士打不过骑士 阿里纳斯称但人们却都指责KD

Posted on

在北京时间8月25日的一期播客节目中,前NBA球员吉尔伯特·阿里纳斯提出了他的观点,认为凯文·杜兰特的加入对金州勇士队起到了挽救的作用。 阿里纳斯:“我们知道勇士队四个人去汉普顿招募杜兰特,他们是获得73胜9负战绩的球队。每个人都在指责杜兰特,却没有人指责勇士。他们的枪不够强大,打不过勒布朗-詹姆斯,所以他们得出去买个火箭筒。” “2016年骑士赢了,如果KD不去勇士,骑士还会赢。我不认为勇士队能击败骑士队,我认为他们的实力不匹配。” Keyword: NBA直播live

News

步行者总裁谈麦康纳续约 他的价值球队一直很重视

Posted on

在北京时间9月4日的新闻报道中,印第安纳步行者队以一份为期四年、总价值4500万美元的合同提前续约了TJ-麦康奈尔。球队的篮球运营总裁凯文-普理查德在采访中谈到了这次麦康奈尔的续约事宜。 谈及麦康纳续约,他表示:“可以肯定地说,NBA的每一支球队都希望有一个像TJ这样拥有同样的强度、竞争精神以及对比赛和队友都有热情的球员。TJ在场上场下都已经成为我们球队中稳定的老将,他对我们球队的价值怎么强调都不为过。他是我们去年成功的重要组成部分,我们很高兴他将继续成为我们正在建设的一部分。” 2023-24赛季,32岁的麦康纳出战71场常规赛,场均18.1分钟,得到10.2分2.7篮板5.5助攻;17场季后赛,场均20.4分钟,得到11.8分3.1篮板5.1助攻。 Keyword: NBA zhibo

News

Excel表格技巧—如何用Right、Left、Mid函数高效整理数据

Posted on

本教程适用版本:WPS 365 点击免费使用 Excel工作表中有很多的函数可以让我们高效的整理数据,那么今天就和大家讲三个最常用的函数的用法,一起来看看吧! 首先第1个是Right函数,Right函数是指从一个文本字符串的最后一个字符开始返回指定个数的字符,比如下图我们如果想在中国北京市这5个字中提取最后面三个字,北京市那么我们就可以这样做: >>免费升级到企业版,赠超大存储空间 首先我们在试剂下方输入,Right函数,然后如图所示,先选择F3,然后第2个输入3,因为我们要提取三个字: >>免费升级到企业版,赠超大存储空间 然后点击回车键就完成了提取市级的操作: >>免费升级到企业版,赠超大存储空间 第2个我们讲left函数,和right函数操作是一样的,Left函数是从一个文本字符串的第1个字符开始返回指定个数的字符: >>免费升级到企业版,赠超大存储空间 如果我们要提取文本中的前面两个字,就可以输入Left函数,第1个空就是我们需要提取的文本,第2个空就是需要提取的字数: >>免费升级到企业版,赠超大存储空间 点击确定就提取完成: >>免费升级到企业版,赠超大存储空间 第3个函数是Mid函数,这个函数就是提取文本中任意的字符,比如我们要提取前面文本中间的三个字,我们就可以按照操作来提取如下图所示: >>免费升级到企业版,赠超大存储空间 同样敲一下回车键就完成了: >>免费升级到企业版,赠超大存储空间 这三个函数你掌握了吗?掌握了这三个非常常用的函数,就可以高效整理我们的数据了! Keyword: wps官网下载

News

杜库在勇士联手的日子里 是篮坛无可匹敌的统治者

Posted on

2024年10月3日,斯蒂芬·库里和凯文·杜兰特这对金州勇士队的传奇组合,虽然只在球场上共同作战了四个赛季,却在这段不长的时间里留下了难以磨灭的印记,他们合作期间两度夺得了NBA总冠军。 这段合作不仅展现了个人才华的极致,更是团队精神的完美体现,让勇士队获得了“篮坛无可匹敌”的美誉。这一荣誉宛若闪耀星空的繁星,照亮了NBA的夜空,突显出他们难以匹敌的统治力。 库里依靠其超凡脱俗的三分射程和无与伦比的组织技巧成为球队进攻的核心;而杜兰特则如同给予人间神圣援助般,他的身高和臂展为他带来了无法比拟的投篮优势,再加上不可思议的单打能力,使得勇士队的进攻更加多样化且难以应对。 两人在场上的默契配合如同双子星般熠熠生辉,在快节奏的推进中或是阵地战中都展现出惊人的击败力,让对手无从应对。 “篮坛无可匹敌”的称号不只是对他们球场表现的褒奖,更是对他们引领的篮球潮流的认可。在那个时代,勇士队以小球为基础,利用快速推进、精确投篮和紧密团队合作,彻底颠覆了传统篮球打法,开启了他们独有的霸业。每一次胜利都重新定义了篮球运动艺术,让全球球迷为之狂热,为之倾倒。 Keyword: NBA直播live