1.背景介绍
REST(Representational State Transfer)意指“表现层状态转化”,是一种用于Web应用的软件 architectural style。它是一种用来创建Web服务的设计风格、协议或方式。RESTful API 是基于HTTP的API,遵循 REST architectural style guidelines。其目标就是通过互联网提供可访问性的、可伸缩的、易于使用的、简洁的接口,能够满足用户的各种需求。本文将会从以下几个方面介绍RESTful API设计的一些基础知识:
-
URI (Uniform Resource Identifier)
URI (Uniform Resource Identifier),即统一资源标识符,用于唯一标识网络上信息资源的字符串。通过URI可以方便地进行资源的定位、检索、更新等操作。 -
HTTP方法
HTTP请求的方法包括GET、POST、PUT、DELETE、HEAD、OPTIONS等。这些方法分别对应了四种基本的CRUD(Create、Read、Update、Delete)操作。一般情况下,GET方法用来获取资源,POST方法用来创建资源,PUT方法用来更新资源,DELETE方法用来删除资源,HEAD方法用来获取响应头部信息,OPTIONS方法用来获取资源支持的HTTP方法。 -
请求参数、返回值
API需要处理的请求参数主要有Path Parameter、Query Parameter、Request Body。请求参数通过URL中的路径参数和查询参数传递;请求Body则通常作为JSON或者XML形式的消息体发