第 10 章 从客户端的角度来看 RESTful API
[日] 涩川喜规
在前面的章节中,笔者介绍了使用 curl 命令或者 Go 语言来进行与 Web 浏览器等价的 HTTP 通信的方法。本章将介绍通过 Go 语言使用 RESTful API 编写代码的方法。这是 Go 语言特有的话题。
本书的主题是“从浏览器的角度学习 HTTP”,所以书中并未站在服务器开发者的立场来介绍 RESTful API 的实现方法和 API 设计。关于这些内容,读者可以参考《RESTful Web Services 中文版》 或前言中介绍的《Web API 的设计与开发》等书。不过,好的 API 是客户端也易于使用的 API,相信服务器开发者在读完本章后也能受到启发。
10.1 RESTfulAPI
10 年前,Mashup 一词非常盛行。Google Maps 等能够处理客户端都无法处理的大容量数据、天气预报等观测系统发来的实时信息的 Web 服务被大量创建。虽然这些服务以使用 Web 浏览器为前提,但它们也提供了 API,可以将这些 Web 服务组合起来使用。将 Web 服务组合起来以创造新的附加价值的方法就叫作 Mashup。像这样,作为 Web 服务的接口,基于 HTTP 的服务器和客户端之间的通信开始被广泛使用。
公开
同步至部落
取消
完成
0/2000
笔记
复制
AI
- 深入了解
- 翻译
- 解释
- 总结
![](https://static001.geekbang.org/resource/image/d0/e4/d0880927e2a522a038be2d04bf19dfe4.png)
本文深入介绍了RESTful API的基本概念和使用方法。RESTful API是一种基于HTTP协议的通信方式,通过Web服务器提供API、使用HTTP方法获取服务、通过状态码通知客户端API是否成功等。与RPC API不同,RESTful API通过URL表示资源的位置,通过HTTP方法进行操作,并且客户端不管理状态,每次请求都是独立执行的。文章还介绍了Web API和事务的关系,以及在RESTful API中实现事务的方法,包括连续调用、使用软件自建事务和使用批处理执行检查程序。此外,文章还介绍了HATEOAS对REST中“接口通用化”的部分进行了标准化,以及RESTful和REST-ish的区别。在使用RESTful API时需要使用服务指定的方法,基本的方法有如下7种:GET、POST、PUT、DELETE、PATCH、HEAD和OPTIONS。其中,经常使用的是前面4个。HTTP规范中以安全和幂等这两个指标对方法进行分类。RESTful API也应该遵循该规则。文章还介绍了常用的状态码,以及响应主体中存储的信息。最后,通过PAY.JP的示例展示了RESTful API的使用方法和认证方式。文章内容涵盖了RESTful API的基本原理、使用方法和实际示例,对于想要了解和使用RESTful API的读者具有很好的参考价值。
仅可试看部分内容,如需阅读全部内容,请付费购买文章所属专栏
《详解 HTTP:协议基础与 Go 语言实现》
《详解 HTTP:协议基础与 Go 语言实现》
立即购买
登录 后留言
精选留言
由作者筛选后的优质留言将会公开显示,欢迎踊跃留言。
收起评论