Restful API-Toy模板网

这篇具有很好参考价值的文章主要介绍了Restful API。希望对大家有所帮助。如果存在错误或未考虑完全的地方，请大家不吝赐教，您也可以点击"举报违法"按钮提交疑问。

一、RESTful API是什么意思

REST 与技术无关，代表的是一种软件架构风格，REST是Representational State Transfer的简称，中文翻译为“表征状态转移”或“表现层状态转化”。

简单来说，REST的含义就是客户端与Web服务器之间进行交互的时候，使用HTTP协议中的4个请求方法代表4个不同的动作。

GET用来获取资源
POST用来新建资源
PUT用来更新资源
DELETE用来删除资源。

只要API程序遵循了REST风格，那就可以称其为RESTful API。目前在前后端分离的架构中，前后端基本都是通过RESTful API来进行交互。

二、对比

不用REST风格来写，那请求的方法和URL就有可能是根据个人喜好去做。可能会有多种写法，开发的时候，其他人可能就没看懂你的意思，或者说导致代码不够整洁优雅。如下：

	r.GET("/book", 对应处理函数)
	r.GET("/create_book", 对应处理函数)
	r.GET("/update_book", 对应处理函数)
	r.GET("/delete_book", 对应处理函数)		// 也可以写成 r.GET("/remove_book", 对应处理函数)，也可以写成r.GET("/shanchu_book", 对应处理函数)

用REST风格来写，会让整个程序代码看起来更加整洁。如下：

	r.GET("/book", 对应处理函数)
	r.POST("/create_book", 对应处理函数)
	r.PUT("/update_book", 对应处理函数)
	r.DELETE("/delete_book", 对应处理函数)

三、小知识

Gin框架支持RESTful API的开发。

开发RESTful API的时候，我们可以用 apifox 来作为客户端的测试工具。

四、代码示例

package main

import "github.com/gin-gonic/gin"

func main() {
	r := gin.Default()

	r.GET("/book", func(c *gin.Context) {
		c.JSON(200, gin.H{
			"message": "GET",
		})
	})
	r.POST("/create_book", func(c *gin.Context) {
		c.JSON(200, gin.H{
			"message": "POST",
		})
	})
	r.PUT("/update_book", func(c *gin.Context) {
		c.JSON(200, gin.H{
			"message": "PUT",
		})
	})
	r.DELETE("/delete_book", func(c *gin.Context) {
		c.JSON(200, gin.H{
			"message": "DELETE",
		})
	})

	r.Run(":9999")
}