RESTful API 设计规范 (mp.weixin.qq.com)

【简介】

该仓库整理了目前比较流行的 RESTful api 设计规范,为了方便讨论规范带来的问题及争议,现把该文档托管于 Github,欢迎大家补充!!

关于「能愿动词」的使用
为了避免歧义,文档大量使用了「能愿动词」,对应的解释如下:

必须 (MUST):绝对,严格遵循,请照做,无条件遵守;

一定不可 (MUST NOT):禁令,严令禁止;

应该 (SHOULD) :强烈建议这样做,但是不强求;

不该 (SHOULD NOT):强烈不建议这样做,但是不强求;

可以 (MAY) 和 可选 (OPTIONAL) :选择性

点击查看全文 >>

@zhisheng_blog 2018-07-16 22:35分享 / 0个评论
赞过的人: 技术头条 zhisheng_blog
要不要再学学下面的文章?
美团民宿跨端复用框架设计与实践 (tech.meituan.com)
从 PC 时代、移动时代到万物互联的 IoT 时代,伴随终端设备的日趋多样化,跨端复用的种子自此落地,开始生根发芽。从业务角度出发,跨端技术演进更多是在不同阶段、不同时间段内业务效率上的选择,美团民宿业务在大前端融合的浪潮中逐浪前行,不断探索和迭代抉择,为解决业务痛点而孵化出跨端框架技术,在这个过程中,我们进行了很多的探索和实践的思考,希望能给大家一些启发。本文主要分享美团民宿在跨端复用技术探索和业务实践过程中的经验。
by @技术头条 2021-06-13 22:39 分享 查看详情
美团MySQL数据库巡检系统的设计与应用 (tech.meituan.com)
本文介绍了美团MySQL数据库巡检系统的框架和巡检内容,希望能够帮助大家了解什么是数据库巡检,美团的巡检系统架构是如何设计的,以及巡检系统是如何保障MySQL服务稳定运行的。
by @技术头条 2021-05-27 08:05 分享 查看详情
如何设计安全的控制系统远程访问 (blog.nsfocus.net)
远程访问有个比较容易被忽视的问题:目前关于远程访问的很多设计/架构已经过时,相关标准需要重新制定和更新以达到当前的安全标准,但是各种设备的涌现导致标准制定需要考虑很多问题。完全杜绝远程访问,采用封闭隔离模式也不是长久之计。

在万物互联和IOT高速发展的情况下,远程连接必不可少,尤其是在工业控制环境中。现场设备的配置更新、界面设置等很多操作无法由安全人员完成,需要由供应商或控制系统现场人员协助。疫情前人们就已经在考虑摒弃传统的人员在设备现场操作模式,疫情的到来更加速了这个需求。一些传统的架构设计已经不允许我们在独立隔离的环境中完成各种操作,我们必须要直面远程访问带来的各种风险。
by @技术头条 2021-05-26 22:40 分享 查看详情
百亿规模API网关服务Shepherd的设计与实现 (tech.meituan.com)
在微服务架构下,服务拆分会让API的规模成倍增长,使用API网关来管理API逐渐成为一种趋势。美团统一API网关服务Shepherd就是在这种背景下应运而生,适用于美团业务且完全自研,用于替换传统的Web层网关应用,业务研发人员通过配置的方式即可对外开放功能和数据。本文将介绍美团统一API网关诞生的背景、关键的技术设计和实现,以及API网关未来的规划,希望能给大家带来一些帮助或者启发。
by @技术头条 2021-05-26 22:37 分享 查看详情
瞧瞧,人家那后端API接口写得多优雅! (mp.weixin.qq.com)
题外话:前后端的工作职责越来越明确,现在的前端都称之为大前端,技术栈以及生态圈都已经非常成熟;以前后端人员瞧不起前端人员,那现在后端人员要重新认识一下前端,前端已经很成体系了。
by @code小生 2021-05-23 23:21 分享 查看详情
12 年!Android 系统的漫漫设计路 (mp.weixin.qq.com)
Android操作系统的历史很悠久。2008年9月,第一款Android手机HTC Dream上市。虽然如今我们很难找到这款手机,但Google提供了每个Android版本的模拟器。
by @code小生 2021-05-09 21:28 分享 查看详情
设计系统简史——过去,现在与可能的未来 (insights.thoughtworks.cn)
按照现在的主流模式,一个设计系统主要由三部分构成:设计原则、风格规范 和模式/组件库 。然而在2005年Sun Microsystems就已经创造出符合现代定义的设计系统了。在瞬息万变的 IT 领域,为什么设计系统经久不衰?我花了一些时间,看了看设计系统的过去和现在,也想了想设计系统的未来。
by @ThoughtWorks 2021-05-07 09:49 分享 查看详情
Google 赢得 Java API版权 (mp.weixin.qq.com)
Google 和 Oracle(甲骨文)在法庭上就 Android 操作系统中 Java 编程语言的使用问题争吵了十年。美国最高法院在周一以 6 比 2 的投票结果裁定,Google 对 Java 代码的使用被归为"合理使用",没有违反联邦版权法 —— 而非 Oracle 辩称的"纯属剽窃",而这一裁定也是此案件的最终结果。
by @code小生 2021-05-05 19:19 分享 查看详情
公司接口裸奔10年了,有必要用API接口签名验证吗? (mp.weixin.qq.com)
请求身份
为开发者分配AccessKey(开发者标识,确保唯一)和SecretKey(用于接口加密,确保不易被穷举,生成算法不易被猜测)。
by @code小生 2021-04-24 20:14 分享 查看详情
卧槽!我随便写的一个 API 竟获得 2.5 亿的访问量 (mp.weixin.qq.com)
简评:作者随手在 Stackoverflow 回答了一个问题,几个月之后,竟发现这个回答带来了 2.5 亿次的 API 访问。作者还因此成立了公司专门运作这个 API。
by @code小生 2021-02-28 11:46 分享 查看详情