实用 Web API 规范--技术头条 -- 微博大V帮你宣传技术博文开发者头条码农头条

【简介】

当开始创建一个新系统，或参与一个新团队或项目时，都会面临一个简单却深刻的问题：这个系统（Web Server）的 API 是否有设计规范？

这个问题困扰了我很长时间，始于我求学时期，每一次都需要与团队成员进行交流和讨论。从最初的自由风格到后来的 REST，我经常向项目组引用 Github v3 和Foursqure API（已经无法访问，暴露年龄）文档。然而，在实践过程中，仍然会有一些与实际工作或公司通用规范不匹配的情况，这时候我需要做一些补充工作。最终，我会撰写一个简要的 DEVELOPMENT.md 文档，以描述设计方案。

但我对该文档一直有更多的想法，它还不够完善。因此，我想整理出一份简单（Simple）而实用（Pragmatic）的 Web API 最佳实践，也就是本文。

点击查看原文 >>

由 @技术头条 2023-04-07 00:37 / 0个评论

赞过的人： @IT技术博客大学习

今天才知道，Web网页也能阻止息屏了 (www.zhangxinxu.com)

Chrome和Safari浏览器都支持了名为Screen Wake Lock的API，可以设置Web网页打开的状态下，显示器屏幕不会自动休眠。

by @技术头条 2024-03-21 22:53 查看详情

Web App: 从 HTML 到 Jamstack (zgq.ink)

Web 领域已发展得十分庞杂，就知识规模来说已不是你我一个人可以穷尽。从 Web 前后端开发角度来看，前端当下正流行着 Next.js、Remix 等 SSR 方案、以及 React 后续继续开发的 Server Component 等等；后端方面则搞出了“云原生”相关的一整套技术生态，各路轮子百花齐放，一不留神就容易沉迷其中而难以自拔。

对于开发者来说，越来越重要的事情也是，放下“穷尽一切”的执念，寻找属于自己的一隅落脚之地。在学习精力、时间有限的背景下，关注点也需要开始区分优先级，关于哪些技术细节值得关注，哪些其实不必花太多时间。

在这寻找落脚之地的旅程中，对事物发展的脉络有一个大致的把握，也变得越来越重要。大致也是需要搞清楚，当前 Web 技术大概发展到了什么样的程度，当下有什么问题正在被解决，哪些技术又可能成为历史包袱被淘汰。

想起我自初中开始接触编程至今，冥冥中伴随着 HTML5 技术从萌芽到成熟的过程，当下 HTML5 已融入我们生活方方面面，乃至于已向客户端开发领域进一步扩展。也许可以就我的所见所想，简单理一理其中经历的一些比较关键的形态，也让我对接下来时间精力大概可以投向的方向有所感知。至于技术细节，网络上有着丰富的资料，这里就不再赘述。

by @技术头条 2024-01-17 23:20 查看详情

剪映APP的视频特效如何在Web中JS实现 (www.zhangxinxu.com)

视频剪辑软件，无论是桌面端还是手机端，都已经被剪映称霸。其中，有个“特效”的标签页，里面有各式各样的效果。

本文会以pixi.js为基础工具，介绍这里面的特效如何在Web网页中实现。

这里面的特效分为了两种：一种是直接改变当前绘制的滤镜，主要是通过解析.frag后缀的文件后渲染实现，例如模糊，扭曲等效果。另外一种是混合滤镜，专门实现一些氛围特效效果，主要是通过解析MP4视频资源（本质是图片序列），然后使用滤色混合模式实现，例如下雨起雾，烟花绽放等效果。

by @技术头条 2023-11-29 23:40 查看详情

Web App: 从 HTML 到 Jamstack (zgq.ink)

Web 领域已发展得十分庞杂，就知识规模来说已不是你我一个人可以穷尽。从 Web 前后端开发角度来看，前端当下正流行着 Next.js、Remix 等 SSR 方案、以及 React 后续继续开发的 Server Component 等等；后端方面则搞出了“云原生”相关的一整套技术生态，各路轮子百花齐放，一不留神就容易沉迷其中而难以自拔。

对于开发者来说，越来越重要的事情也是，放下“穷尽一切”的执念，寻找属于自己的一隅落脚之地。在学习精力、时间有限的背景下，关注点也需要开始区分优先级，关于哪些技术细节值得关注，哪些其实不必花太多时间。

by @技术头条 2023-11-29 23:36 查看详情

为什么需要 “API 网关”？ (www.addesp.com)

在 OSI 模型的网络层中，网关通常指路由器，因为它可以实现局域网间的数据互通。API 网关的作用也类似，即接受客户端的请求，转发客户端的请求，转发服务端的响应给客户端。

那么这和客户端直接请求有什么区别呢？一大区别就是 API 网关可以将不同服务的接口聚合成一个接口，客户端只要请求一次，API 网关就可以根据请求向若干个服务发起请求，等到请求完成后，一起返回给客户端。

by @技术头条 2023-11-06 23:29 查看详情

聊聊Web网页中资源加载的优先级 (www.zhangxinxu.com)

通过调整或设置资源加载的优先级或者先后顺序，可以让页面重要的资源优先加载，让不重要的内容之后加载，以提高页面的访问体验。

通过文中的视频比较显示了 Google 机票页面，其中加载了使用和不使用“提取优先级”加载的 LCP 背景图片。将优先级设置为“高”后，LCP 时间从 2.6 秒缩短到 1.9 秒。

by @技术头条 2023-10-30 23:06 查看详情

低碳 Web 实践指南 (insights.thoughtworks.cn)

本文探讨了如何构建低碳 Web 应用来应对气候变化和碳排放问题。文章指出，通过精简压缩 Web 应用、降低数据传输量以及优化应用性能等措施，可以减少碳排放。文章还强调了在软件开发生命周期中落地相关举措的重要性，并提供了一些测试工具和实践经验。

by @Thoughtworks 2023-08-02 15:14 查看详情

浅议非典型 Web 应用场景下的身份认证 (blog.yuanpei.me)

回想起刚毕业那会儿，因为没有 Web 开发的经验而被人轻视，当年流行的 SSH 全家桶，对我鼓捣 Windows 桌面开发这件事情，投来无限鄙夷的目光，仿佛 Windows 是一种原罪。可时间久了以后，我渐渐意识到，对工程派而言，一切都是工具；而对于学术派而言，一切都是包容。这个世界并不是只有 Web，对吧？所以，这篇博客我想聊聊非典型 Web 应用场景下的身份认证。

by @技术头条 2023-07-30 17:29 查看详情

如何在命令行中安全存取密钥信息：以 OpenAI API 密钥为例 (type.cyhsu.xyz)

大量涌现的 AI 项目引发了如何有效管理和取用 API 密钥的问题。每次复制粘贴过于麻烦，明文写进配置文件也不安全。但通过合理利用内置功能或第三方工具，就能用加密存储代替明文密钥，达到兼顾安全和便捷的目的。

by @技术头条 2023-07-23 12:30 查看详情

Web性能评价指标 (insights.thoughtworks.cn)

遇见用户抱怨性能时，不要先入为主地判定性能差，逐个排查系统可能有的性能问题，优化非最佳实践。而应该理性地以用户为中心，收集真实用户数据，衡量系统性能好坏。

by @Thoughtworks 2023-03-24 09:57 查看详情