Excel Services REST API的URI - 腾讯云开发者社区 - 腾讯云

开发者社区

文档建议反馈控制台

文章/答案/技术大牛

发布

REST API URI 设计的七准则

在了解 REST API URI 设计的规则之前，让我们快速过一下我们将要讨论的一些术语。 URI REST API 使用统一资源标识符（URI）来寻址资源。...REST API 设计人员应该创建 URI，将 REST API 的资源模型传达给潜在的客户端开发人员。在这篇文章中，我将尝试为 REST API URsI 引入一套设计规则。...两个不同的 URI 映射到两个不同的资源。如果 URI 不同，那么资源也会不同，反之亦然。因此，REST API 必须生成和传达清晰的 URI，并且不应容忍任何客户端尝试去对一个资源进行模糊的标识。...规则＃6：文件扩展名不应包含在 URI 中在 Web 上，字符（.）通常用于分隔 URI 的文件名和扩展名。一个 REST API 不应在 URI 中包含人造的文件扩展名，来表示消息实体的格式。...URI 的名称和结构应该向消费者传达意义。通过遵循上述规则，你将创建一个更加清晰的 REST API。这不是一个 REST 规则或约束，而是增强了 API。

1.9K4 0

REST API URI的七大设计原则

在了解REST API URI设计的规则之前，让我们快速浏览一些我们将要讨论的术语。 URIs REST API使用统一资源标识符（URI）来寻址资源。...REST API设计人员应该在考虑将REST API资源模型传达给潜在的客户端开发者的前提下，创造URI。在这篇文章中，我将尝试为REST API URI 引入一套设计规则。...两个不同的URI映射到两个不同的资源。如果URI不同，那么资源也是如此，反之亦然。因此，REST API必须生成和传递精确的URI，不能容忍任何的客户端尝试不精确的资源定位。...结论当你在设计REST API服务时，您必须注意这些由URI定义的资源。正在构建的服务中的每个资源将至少有一个URI标识它。这个URI最好是有意义的，且能充分描述资源。...URI的名称和结构应该能够向使用者传达更清晰的含义。通过遵循上述规则，您将创建一个更清晰的的REST API与更友好的客户端。这些并不是REST的规则或约束，仅仅是API的增强和补充。

2.3K6 0

您找到你想要的搜索结果了吗？

是的

没有找到

Web API和Web Services的区分

Web Services是 Web API的子集，其仅包含 SOAP、REST 和 XML-RPC 三种类型。Web Services需要使用网络才能操作。...特点：协议支持：通常使用SOAP（Simple Object Access Protocol）协议，也支持REST风格的服务。数据格式：主要使用XML作为数据交换格式。...相比于XML，JSON是一种轻量级的数据交换格式，在Web Services中传输更快。Web API是 Web Services 的超集。...除了前面提到的三种类型，还有其他类型的Web Services 存在于Web API中，如 JSON-RPC。Web API不一定需要网络操作。...特点：协议支持：大多数Web API采用REST（Representational State Transfer）架构风格，但也可能基于其他协议如GraphQL。

1.1K0 0

REST API和GraphQL API的比较

REST API REST（表述性状态传输）API 是一种应用程序接口 (API) 的架构风格，它使用 HTTP 请求来访问和使用数据。...GraphQL 与 REST： GraphQL 和 REST API 之间的主要区别在于 GraphQL 是一种查询语言，而 REST 是一种基于网络的软件的架构概念。...可用性 REST API 使用 URI 和 HTTP 技术，这使得 API 很难预测在联系新端点时会发生什么。REST 中缺少指定的版本控制要求允许提供者采用他们自己的方法。...因此，无法像 REST API 那样缓存查询。但是，由于可用的工具，客户端缓存优于 REST。...与 REST API 相比，这是一个明显的区别，在 REST API 中，每个状态代码都指向某种类型的响应。

1.7K1 0

撰写合格的REST API

稍稍总结了些经验，在这篇文章里讲讲如何撰写「合格的」REST API。 RFC一致性 REST API一般用来将某种资源和允许的对资源的操作暴露给外界，使调用者能够以正确的方式操作资源。...一个合格的REST API需要根据Accept头来灵活返回合适的数据。...Request URI和Request body是否合法：如果请求带有了不该有的数据，或者某些必须包含的数据没有出现或内容不合法，一律返回4xx。...一般而言，如果对REST API的安全性要求比较高，那么，所有的API的所有操作均需得到授权。...（Amazon HMAC图示）在做HMAC的时候，request headers中的request method，request URI，Date/X-Auth-Timestamp等header会被计算在

2.1K5 0

REST API和SOAP API之间的区别

The Representational State Transfer (REST)架构风格不是可以购买的技术，也不是可以添加到软件开发项目中的库。...REST是一种世界观，将信息提升为我们构建的体系结构的第一流元素。 Roy Fielding博士的论文“架构风格和基于网络的软件架构设计”介绍并整理了用于描述“RESTful”系统的思想和术语。...“无状态”这个术语是一个至关重要的部分，因为它允许应用程序以不一样的方式进行通信。一个RESTful API服务通过统一资源定位器(URL)公开。这个逻辑名称将资源的标识与所接受或返回的标识分开。...这是最常见的请求，每次在浏览器中键入URL并单击return、选择书签或单击锚点引用链接时执行。对于与RESTful API的编程交互，可以使用十几种或更多的客户端API或工具。...如果没有对RESTful架构实现的更宏观的理解，很容易失去实践的意图。 REST最好用于管理系统，通过将产生和使用它的技术产生和使用的信息解耦。

2.8K1 0

REST API和SOAP API之间的区别

大家好，又见面了，我是你们的朋友全栈君。 The Representational State Transfer (REST)架构风格不是可以购买的技术，也不是可以添加到软件开发项目中的库。...“无状态”这个术语是一个至关重要的部分，因为它允许应用程序以不一样的方式进行通信。一个RESTful API服务通过统一资源定位器(URL)公开。这个逻辑名称将资源的标识与所接受或返回的标识分开。...这是最常见的请求，每次在浏览器中键入URL并单击return、选择书签或单击锚点引用链接时执行。对于与RESTful API的编程交互，可以使用十几种或更多的客户端API或工具。...基于rest的请求的一个重要方面是，每个请求包含足够的状态来响应请求。这就允许服务器上的可见性和无状态性、扩展系统所需的属性以及识别正在发出的请求。这种状态还允许缓存特定的结果。...如果没有对RESTful架构实现的更宏观的理解，很容易失去实践的意图。 REST最好用于管理系统，通过将产生和使用它的技术产生和使用的信息解耦。

2K2 0

你确定你的 REST API 真的符合 REST 规范？

RESTful API 的存在是 web 开发历史上的一个里程碑。在本文中，我将和你探讨几种节省 REST API 开发时间的方法，并给出相关的 Node.js 示例。...RESTful API 背后的思想是遵循REST 规范中描述的所有架构规则和限制的方式进行开发。然而，实际上，这在实践中基本上是不可能的。一方面，REST 包含了太多模糊和模棱两可的定义。...REST API 规范能做什么? 尽管存在上面说到的缺点，但使用合理的方法，REST 仍然是创建真正优秀 api 的一个绝佳选择。...因为你通过高质量的 API 规范实现的 api 将会是一致的，具有清晰的结构、良好的文档和高的单元测试覆盖率。通常，REST API规范与其文档相关联。...这将使使用你的 API 的开发人员感到轻松，并且肯定比手工填写 REST API 文档模板要好。

1.5K2 0

优雅调试 REST API 的工具

找到一个超级漂亮同时功能超级强，还是一个 UWP 应用的调试 REST API 工具点击此地址下载安装界面截图 ?...支持对请求设置标题，同时支持分组和工作空间如我可以对访问逗比服务器添加多个不同的 API 请求 ?...我可以对一个项目的不同功能设置不同的分组，同时还可以切换工作空间不过切换空间是需要升级为专业版的当然清真的是这是一个 UWP 程序我没有收他的红包，所以不好用请到官网喷 ---- 本文会经常更新...，请阅读原文： https://blog.lindexi.com/post/%E4%BC%98%E9%9B%85%E8%B0%83%E8%AF%95-REST-API-%E7%9A%84%E5%...B7%A5%E5%85%B7.html ，以避免陈旧错误知识的误导，同时有更好的阅读体验。

1.3K1 0

REST API 和 GraphQL的比较

REST（Representational State Transfer）和GraphQL是两种常见的API设计风格，各自有其独特的特点和适用场景。...在API设计方面，REST和GraphQL各有其优势和劣势。...REST（Representational State Transfer）: REST是一种基于资源的状态转移的架构风格，旨在通过操作资源的表现层（通常是JSON或XML格式）来进行通信。...下面的图表展示了REST和GraphQL的快速比较。 REST API: 架构风格：基于资源的状态转移（Representational State Transfer）。...REST在简单的场景中表现出色，而GraphQL更适用于需要更大灵活性和精确数据控制的复杂应用程序。

8231 0

Flink REST API 的设计指南

Flink REST API 介绍Flink REST API 是 JobManager 提供的 HTTP 接口，用户可以通过 GET、POST 等 REST 定义的方法，请求获取作业、JobManager...非阻塞的 Flink REST API 设计要点关于拓展 Flink REST API 的方法，我们可以在 Flink 官网文档、各类技术社区文章中得到详细的指引，因而这里不再赘述基础的细节，而是更侧重于讲解遇到的一些常见的问题和解决方案...→ TaskManager → 用户定义的 Task请求体、返回体设计通常对于接受 GET 方法的 REST API 而言，可以直接使用 EmptyRequestBody 类作为请求体的结构，方便快捷...但对于 POST 方法的 API，我们通常需要实现 RequestBody 接口，来定义该 REST 接口的请求体。...REST Handler 设计handler 是一个 REST API 接口的执行者，我们可以通过实现 handleRequest 方法来定义请求的处理逻辑。

2.2K2 0

聊聊Eureka Server的REST API

序本文主要研究下Eureka Server的REST API ApplicationsResource eureka-core-1.8.8-sources.jar!...replicationList) { //.... } } 这里提供一个接口 POST /{version}/peerreplication/batch 小结 eureka server的rest...api是使用javax.ws实现的。...然后spring cloud的版本，其version传的是eureka值。使用javax.ws实现的接口，感觉比起spring mvc来说，非常不好找映射，稍微有点费劲。...doc Eureka REST operations

1.9K1 0

Ambari 常用的 REST API 介绍

Ambari 借鉴了很多成熟分布式软件的 API 设计。 Rest API 就是一个很好地体现。通过 Ambari 的 Rest API，可以在脚本中通过 curl 维护整个集群。...并且，我们可以用 Rest API 实现一些无法在 Ambari GUI 上面做的操作。下面是一些实例。...幸运的是 Ambari 提供了 DELETE 的 Rest API，我们可以通过该 API 来删除 Ambari 中 Service。...通过这三个简单实例，就可以体会到 Ambari Rest API 的作用。...在 Rest API 的基础上，就算脱离了 WEB，我们也可以很好地控制 Ambari。当然，我们也不得不记住很多生涩的参数。

1.8K2 0

URI设计原则，你设计的API做到了么？

咱们设计的REST API真的nice么？...使用“-”提高URI的可读性目的是使得URI便于理解，用“-”来连接单词正面case：http://api.example.com/blogs/my-first-post 3....不要在URI中包含扩展名应鼓励REST API客户端使用HTTP提供的格式选择机制Accept request header 正面case：http://58.com/bj/ershou/310976.../api.college.com/student/3248234/course 最后，给后端研发工程师一个建议：清晰优雅的 RESTful API是为调用者编写的，别无脑随意定义一些shit一样的URI...原文：http://blog.restcase.com/7-rules-for-rest-api-uri-design/

1.1K5 0

RESTful架构REST名称REST的出处RESTful API各端的具体实现

REST不是"rest"这个单词，而是几个单词缩写。 1....REST描述的是在网络中client和server的一种交互形式；REST本身不实用，实用的是如何设计 RESTful API（REST风格的网络接口）； 2....Server提供的RESTful API中，URL中只使用名词来指定资源，原则上不使用动词。“资源”是REST架构或者说整个网络处理的核心。...Transfer (REST) RESTful API 为什么要用RESTful结构呢？...API versioning: 可以放在URL里面，也可以用HTTP的header： /api/v1/ 3. URI使用名词而不是动词，且推荐用复数。

2K5 0

【API架构】REST API 设计的原则和最佳实践

这是一个完整的图表，可以轻松理解 REST API 的原理、方法和最佳实践。现在，让我们从每个盒子的原理开始详细说明它。...基于资源：在请求中使用 URI 作为资源标识符来标识单个资源。资源本身在概念上与返回给客户端的表示分开。...最佳实践现在，让我们换个角度来了解 REST 的基本最佳实践，这是每个工程师都应该知道的。保持简单和细粒度：创建模拟系统底层应用程序域或系统数据库架构的 API。...为您的客户设计，而不是为您的数据设计。 - 复数：普遍接受的做法是始终在节点名称中使用复数形式，以保持您的 API URI 在所有 HTTP 方法中保持一致。...本文 https://jiagoushi.pro/principles-best-practices-rest-api-design 讨论：知识星球【首席架构师圈】或者加微信小号【cea_csa_cto

2.1K1 0

Python调用REST API接口的几

相信做过自动化运维的同学都用过REST API接口来完成某些动作。API是一套成熟系统所必需的接口，可以被其他系统或脚本来调用，这也是自动化运维的必修课。...本文主要介绍python中调用REST API的几种方式，下面是python中会用到的库。...urllib2 - httplib2 - pycurl - requests urllib2 - Sample1 import urllib2, urllib github_url = 'https://api.github.com...some test repo'}) r = requests.post(github_url, data, auth=('user', '*****')) print r.json 以上几种方式都可以调用API

4.6K4 0

带有 Python REST Web 服务示例的 REST API 快速入门指南

客户端服务器这个约束规定客户端和服务器的实现应该是独立的，两者都应该能够相互独立地扩展和发展。客户端应该只知道服务器上资源的 URI，别无其他。服务器应根据收到的客户端请求返回适当的响应。 2....统一接口这表明组件之间需要统一接口，服务器中的每个资源都应该只有一个逻辑 URI，并且应该公开访问该资源的方法，并且应该遵循标准的命名约定。应使用通用方法访问所有资源。...创建 API 端点和 REST 方法接下来，我们需要创建 api 端点和所需的 REST 方法，如下所示。 GET 方法将在文章列表中搜索请求的类别，如果找到则返回数据以及响应代码 200 OK。...def delete(self,category): 4.注册资源并分配URI 我们的最后一步是将我们的资源注册到 REST API 并为其分配一个 URI。...api.add_resource(Article, "/category/") TGS.run(debug=True,port=8080) 完整的 REST 示例程序

3.1K0 0

soapui系列|基于rest 的api测试

SoapUI是一个开源测试工具，通过soap/http来检查、调用、实现Web Service的功能/负载/符合性测试。...本文介绍基于rest的接口测试，从创建项目到编写case到断言，一步步教会你如何写一个接口测试用例。...第一节：创建要测试restapi 创建一个rest project 创建一个rest 服务创建一级资源创建二级资源创建多级资源:继续添加child resource即可第二节：根据创建好的...rest服务生成testsuit,testcase和teststep 选中最低级子资源的request右键 2.选择add to TestCase 3.创建新的testsuite...4.创建新的testcase 5.创建新的teststep 第三节：补充测试相关脚本，数据库查询，断言 1.添加断言完成设置 ----

1.4K4 0

正确甄别API、REST API、RESTful API和Web Service之间的异同

REST API是一组关于如何构建Web应用程序API的架构规则、标准或指导，或者说REST API是遵循API原则的一种架构风格。...如果按照数学上集合的概念来解释API与REST API之间的联系与区别，API是REST API的超集，REST API 是API的子集；所有的REST API都是API，但不是所有的API都是REST...2、REST API 与RESTful API 在第一小节中，了解了什么是REST API，接下来聊聊REST API与RESTful API之间的异同。...也就是说，RESTful API是REST API的非正式实现方式，因为实现REST API的方式有很多，RESTful API只是其中一种，且没有完全满足REST API的所有设计原则，每个开发者在实现...REST API是API的一个子集，所有的REST API都是API；RESTful API是对REST API架构风格的一种非正式实现方式。

29K13 13

点击加载更多

相关资讯

热门标签

活动推荐

运营活动

活动名称

广告关闭