当前位置：网站首页 > 技术文章 > 正文

良好的URI设计的一些基本原则（uri设计应遵循原则）

nanshan 2024-10-21 06:04 20 浏览 0 评论

良好的URI设计的一些基本原则

不要使用查询参数来更改状态。
不要使用大小写混用的路劲除非有必要，最好的都是小写字母。
不要使用实现特定的扩展你的URI（php，py，PL，等。）
不要让你的URI有远程过程调用（RPC）的缺陷
尽可能多地限制URI空间。
保持路径段短
最好用/resource或者/resource/；同时为你没有用到的路径创建301重定向
使用查询参数对于一个子资源的选择；如分页、搜索查询
不要在URL中填写任何东西，应该放在HTTP头或正文中去。

（注意：我没有说“RESTful URI设计”；URI本质上是不透明的REST。）

HTTP方法选择的11个基本原则：

永远不要GET去改变状态；这会让Googlebot毁掉你的一天
不要用PUT，除非你要更新整个resource
不要用PUT，除非你可以一直合法的用GET在同一个URI上
不要用POST来检索信息，那是长效的并且可能被缓冲
不要执行一个操作是非幂等的PUT
尽可能使用get
当不确定使用PUT还是POST时，优先使用POST
要使用POST当你需要做一些类似RPC时
对类较大或层次的资源使用PUT
删除资源时，优先选择DELETE而不是POST
在做计算之类的请求时，优先使用GET；除非你的INPUT很大，这是你可以考虑使用POST

Web服务中HTTP设计的一般原则：

不要将元数据放在body中，应该放在header中。
不要将元数据放在单独的资源中，除非当包含元数据时会造成很大的开销。
使用适当的状态码

201 Created指创建资源时；在发送响应时资源必须存在
202 Accepted指成功执行一个操作或异步创建资源
400 Bad Request指当有人用伪造的数据进行操作；应用程序可能是一个验证错误；一般保存为500的未捕获的异常
401 Unauthorized指当某人访问您的API时，未提供必要的授权header或授权中的凭据无效时；如果您不希望通过授权header来进行凭证，则不要使用此响应代码。
403 Forbidden指当某人恶意或未经授权的方式访问你的API时
405 Method Not Allowed指当本来必须用PUT，而有人却POST时，等等
413 Request Entity Too Large指当某人试图发送一个无法接收的大文件时
418 I’m teapot 指当我试图用茶壶冲泡咖啡时

尽可能使用缓存Headers

ETag headers让你很容易的将资源设置为哈希值
Last-Modified向你表明，保留资源更新时的时间戳是一个好主意。
Cathe-Control和Expires应该有一个合理的值。

尽一切可能执行请求中的缓存headers（If-None-Modified, If-Modified-Since）
使用重定向的时一定要有意义，但这应该是罕见的Web服务

405 not allowed

上一篇：HTTP协议——处理状态和返回状态码含义
下一篇：简洁 RESTful API 设计规范!整个人都清爽了

相关推荐

如何为MySQL服务器和客户机启用SSL?: 用户想要与MySQL服务器建立一条安全连接时，常常依赖VPN隧道或SSH隧道。不过，获得MySQL连接的另一个办法是，启用MySQL服务器上的SSL封装器(SSLwrapper)。这每一种方法各有其...

Mysql5.7 出现大量 unauthenticated user: 线上环境mysql5.7突然出现大量unauthenticateduser,进mysql，showprocesslist;解决办法有：在/etc/hosts中添加客户端ip，如192.16...

MySQL 在 Windows 系统下的安装（mysql安装教程windows）: 更多技术文章MySQL在Windows系统下的安装1.下载mysql和Framework链接链接：百度网盘请输入提取码提取码：6w3p双击mysql-installer-communit...

MySql5.7.21.zip绿色版安装（mysql数据库绿色版安装）: 1、去网上下载满足系统要求的版本（mysql-5.7.21-winx64.zip）2、直接解压3、mysql的初始化（1）以管理员身份运行cmd，在mysql中的bin目录下shift+右键-在...

MySQL(8.0)中文全文检索 (亲测有效): 在一堆文字中找到含有关键字的应用。当然也可以用以下语句实现：SELECT*FROM<表名>WHERE<字段名>like‘%ABC%’但是它的效率太低，是全盘扫描。...

新手教程，Linux系统下MySQL的安装: 看了两三个教程。终于在哔哩哔哩找到一个简单高效的教程，成功安装，up主名叫bili逍遥bili，感兴趣可以去看看。下面这个是我总结的安装方法环境：CentOS764位1.下载安装包，个人觉得在...

麒麟服务器操作系统安装 MySQL 8 实战指南: 原文连接：「链接」Hello，大家好啊，今天给大家带来一篇麒麟服务器操作系统上安装MySQL8的文章，欢迎大家分享点赞，点个在看和关注吧！MySQL作为主流开源数据库之一，被广泛应用于各种业务...

用Python玩转MySQL的全攻略，从环境搭建到项目实战全解析: 这是一篇关于“MySQL数据库入门实战-Python版”的教程，结合了案例实战分析，帮助初学者快速掌握如何使用Python操作MySQL数据库。一、环境准备1.安装Python访问Pytho...

安装MySQL（中标麒麟安装mysql）: 安装MySQL注意：一定要用root用户操作如下步骤；先卸载MySQL再安装1.安装包准备（1）查看MySQL是否安装rpm-qa|grepmysql（2）如果安装了MySQL，就先卸载rpm-...

Mysql最全笔记，快速入门，干货满满，爆肝: 目录一、MySQL的重要性二、MySQL介绍三、软件的服务架构四、MySQL的安装五、SQL语句六、数据库相关（DDL）七、表相关八、DML相关（表中数据）九、DQL（重点）十、数据完...

MAC电脑安装MySQL操作步骤（mac安装mysqldb）: 1、在官网下载MySQL：https://dev.mysql.com/downloads/mysql/根据自己的macOS版本，选择适配的MySQL版本根据自己需求选择相应的安装包，我这里选择macO...

mysql主从（mysql主从切换）: 1、本章面试题什么是mysql主从，主从有什么好处什么是读写分离，有什么好处，使用mycat如何实现2、知识点2.1、课程回顾dubboORM->MVC->RPC->SOApro...

【linux学习】以MySQL为例，带你了解数据库: 做运维的小伙伴在日常工作中难免需要接触到数据库，不管是MySQL，mariadb,达梦还是瀚高等其实命令都差不多，下面我就以MySQL为例带大家一起来了解下数据库。有兴趣的小伙伴不妨评论区一起交流下...

玩玩WordPress - 环境简介(0)（玩玩网络科技有限公司）: 简介提到开源博客系统，一般都会直接想到WordPress！WordPress是使用PHP开发的，数据库使用的是MySQL，一般会在Linux上运行，Nginx作为前端。这时候就需要有一套LNMP（Li...

服务器常用端口都有哪些?（服务器端使用的端口号范围）: 下面为大家介绍一下，服务器常用的一些默认端口，以及他们的作用：　　21：FTP服务所开放的端口，用于上传、下载文件。　　22：SSH端口，用于通过命令行模式远程连接Linux服务器或vps。　　23：...

取消回复欢迎你发表评论:

一周热门

最近发表

首页
收录
顶部