首页
学习
活动
专区
圈层
工具
发布

REST API URI 设计的七准则

在了解 REST API URI 设计的规则之前,让我们快速过一下我们将要讨论的一些术语。 URI REST API 使用统一资源标识符(URI)来寻址资源。...REST API 设计人员应该创建 URI,将 REST API 的资源模型传达给潜在的客户端开发人员。在这篇文章中,我将尝试为 REST API URsI 引入一套设计规则。...许多 Web 组件和框架将平等对待以下两个 URI: http://api.canvas.com/shapes/ http://api.canvas.com/shapes 然而,URI 中的每个字符都会被计入作为资源的唯一标识...两个不同的 URI 映射到两个不同的资源。如果 URI 不同,那么资源也会不同,反之亦然。因此,REST API 必须生成和传达清晰的 URI,并且不应容忍任何客户端尝试去对一个资源进行模糊的标识。...URI 的名称和结构应该向消费者传达意义。通过遵循上述规则,你将创建一个更加清晰的 REST API。这不是一个 REST 规则或约束,而是增强了 API。

1.9K40
  • 您找到你想要的搜索结果了吗?
    是的
    没有找到

    REST API URI的七大设计原则

    在了解REST API URI设计的规则之前,让我们快速浏览一些我们将要讨论的术语。 URIs REST API使用统一资源标识符(URI)来寻址资源。...REST API设计人员应该在考虑将REST API资源模型传达给潜在的客户端开发者的前提下,创造URI。在这篇文章中,我将尝试为REST API URI 引入一套设计规则。...许多Web组件和框架将平等对待以下两个URI: http://api.canvas.com/shapes/ http://api.canvas.com/shapes 但是,实际上URI中的每个字符都会计入资源的唯一身份的识别中...两个不同的URI映射到两个不同的资源。如果URI不同,那么资源也是如此,反之亦然。因此,REST API必须生成和传递精确的URI,不能容忍任何的客户端尝试不精确的资源定位。...最后,望大家牢记:你在为你的客户端设计API URI,而不仅仅是为你的数据。

    2.3K60

    api网关怎么获取uri路径 api如何处理局部访问失败

    下面来了解一下api网关怎么获取uri路径。 api网关怎么获取uri路径 api网关的作用是多种多样的,获取uri路径是其中之一,那么api网关怎么获取uri路径呢?...所有的uri地址和uri路径都会提前设置在api网关当中,方便于api网关对于不同身份的用户进行筛选和过滤。...api如何处理局部访问失败 上面了解了api网关怎么获取uri路径,那么api如何处理局部访问失败的情况呢?...由于api网关实行的是一个协调功能,因此在某些微服务出现故障的时候,它可以保障其他微服务功能的正常使用,并且为故障的微服务提供熔断降级处理等等方式。 以上就是api网关怎么获取uri路径的相关内容。...获取uri路径是api网关的一个重要核心功能,因此多了解一些相关知识,有助于工作人员以及技术人员对于api网关更好的管理和使用。

    1.9K30

    图形存储数据库Neo4j

    《NoSQL数据库技术与应用》 教学设计 课题 名称 第9章 图形存储数据库Neo4j 计划学时 5 课时 内容 分析 图形存储数据库也是NoSQL数据库的一种类型,它主要是应用图形理论存储实体之间的关系信息...常见的图形存储数据库有Neo4j、FlockDB以及AllegroGrap。由于Neo4j数据库是目前最流行、稳定的图形存储数据库,因此,本章将针对Neo4j数据库的相关知识进行详细讲解。...教学目标及基本要求 1、熟悉Neo4j概述 2、理解Neo4j的数据模型 3、掌握Neo4j的部署 4、掌握Neo4j的Cypher操作 5、掌握Neo4j的Java API操作 教学 重点 1、Neo4j...的Cypher操作 2、Neo4j的Java API操作 教学 难点 基于Linux平台部署Neo4j 教学 方式 教师课堂教学要以讲演法讲授为主,并结合多媒体进行教学。

    45610

    文本存储免费API接口教程

    接口简介本接口由接口盒子提供文本存储API提供免费的文本存储服务,支持存储1000条文本记录(每条记录最大5000字符)。适用于公告存储、日志管理、配置信息存储等场景,支持修改和读取操作。...GET请求示例bash复制https://cn.apihz.cn/api/cunchu/textcc.php?...>​Python实现​:python运行复制import requests# 修改记录def update_text(): url = "https://cn.apihz.cn/api/cunchu...", "title": "标题文本"}​错误响应​:json复制{ "code": 400, "msg": "通讯秘钥错误"}使用场景​公告系统​:存储网站公告内容​配置管理​:保存系统配置参数​日志存储​...:记录关键操作日志​临时数据​:存储需要跨会话共享的数据

    30100

    计算型存储-2:标准、API实现

    ,卸载主机的计算任务,结构上为:资源控制器+设备缓存; • CSD是集成到主机上的计算存储驱动,与CSP不同的是,因驱动器含存储设备,故额外增加:存储控制器+存储设备; • CSA是计算存储阵列,是端侧具备完整能力的架构...上述定义了架构设计和对应功能模块,对于软件开发人员来说,关心的是接口(API)的调用规范和功能。...不同的应用程序可以通过SNIA CS API library调用相应的CSF功能,如搜索、解密、解压等等。...图示调用压缩API的内部工作流程: • 分配设备内存(FDM) • 从存储加载数据 • 在已加载的数据上运行数据过滤CSF • 将结果复制到主机内存 更细致描述API调用过程。...计算型存储架构与组件 SNIA定义了计算型存储三大架构:CSP(扩展处理器模块)、CSD(计算存储驱动)和CSA(计算存储阵列),各有应用场景,CSA能管理多CSD。

    44110

    Vulkan入门教程:探索低级图形API的奥秘

    前言嘿,各位图形编程爱好者!今天我要和大家聊聊Vulkan这个超级强大(但也有点吓人)的图形API。还记得第一次听说Vulkan时,我内心既兴奋又忐忑 - 这可是被誉为"下一代OpenGL"的技术啊!...简单来说,Vulkan是一个低级图形和计算API,由Khronos Group(也是OpenGL的开发组织)开发。它于2016年首次发布,旨在提供更接近现代GPU硬件的编程接口。...但什么是"低级API"呢?...缓冲区和图像缓冲区(Buffer) 是线性内存块,通常用于存储顶点数据、索引数据或统一数据。图像(Image) 是多维数据数组,用于纹理、渲染目标等。...Sascha Willems的示例 - 实用的例子集合Khronos Group的Vulkan指南它能捕获错误使用API的情况并提供详细信息RenderDoc优秀的图形调试工具,可以捕获和分析Vulkan

    62210

    【译】让图片更有意义——图形检测API

    图形检测API是一组JavaScript接口,通过调用这些接口来调用原生设备的探测功能。...图形检测API的使用场景 图形检测API目前支持人脸,条形码和文本的检测。以下列出了这三个功能的使用场景: 人脸检测 社交网络或是图片社交网站通常给用户提供图片中对人物进行编辑标记的功能。...进展情况 项目 进度 创建解释器 已完成 构建草案规范 进度中 反馈收集和设计 进度中 浏览器验证 进度中 发布 未开始 图形检测API的使用 FaceDetector、BarcodeDetector...api构造函数是否存在是不够的,因为在Linux和Chrome OS上的Chrome在图形检测API不起作用的情况下仍然会暴露出探测器接口(这是个bug),在这种情况下,我们建议使用以下特征检测的临时方案...并不是所有的平台都支持这些功能,所以一定要进行特征检测检查支持情况,并把图形检测API视为渐进增强的功能。

    1.1K20

    COSI 简介:使用 Kubernetes API 管理对象存储

    对象存储不存在等效标准。 近年来,对象存储作为文件系统和块设备的替代存储形式越来越受欢迎。 对象存储范式促进了计算和存储的分解,这是通过网络而不是本地提供数据来完成的。...COSI COSI 旨在标准化对象存储的使用,以提供以下好处: Kubernetes 原生 - 使用 Kubernetes API 来制备、配置和管理 Bucket 自助服务 - 明确划分管理和运营 (...API 时才有可能。...即使集群中使用了多个对象存储提供程序,也只需要一个。 COSI 边车充当 COSI API 请求和供应商特定 COSI 驱动程序之间的转换器。...由于对象存储始终通过网络进行身份验证,因此需要访问凭证才能访问 Bucket。 BucketAccess 和 BucketAccessClass 这两个 API 用于表示访问凭证和身份验证策略。

    1.7K30

    JavaScript是如何工作的:存储引擎+如何选择合适的存储API

    正确的存储缓存策略是实现离线移动 Web 体验的核心构建块,同时也大大的提高了用户体验。 在本章中,讨论可选择的存储 Api 和服务,并提供一些在构建 Web应用程序,该使用哪种存储引擎。...同步/异步 — 有些存储 Api 是同步的,因为存储或检索请求会阻塞当前活动的线程,直到请求完成。使用同步存储 API 会阻塞主线程,并为 Web 应用程序的 UI 创建冻结体验。...如果可能,使用异步API。 比较 在本节中,了解决 Web 开发人员的当前可用存储 Api,并从各个维度上进行比较。 ? 文件系统API ?...选择正确的存储API 如前所述,最好选择尽可能多的浏览器广泛支持的 Api,并提供异步调用模型,以最大限度地提高 UI 响应能力。...这些标准自然会导致以下技术选择: 对于离线存储,请使用 Cache API。

    2.3K10
    领券