1.什么是restful
RESTful 风格是一种基于 HTTP 协议设计 Web API 接口的风格,其核心原则包括资源、统一接口、无状态和可缓存性。
在 RESTful 风格中,每一个 URI 表示一个资源,并使用 HTTP 方法来表示针对该资源的不同操作。常用的 HTTP 方法包括:
- GET:获取资源
- POST:创建资源
- PUT:更新资源
- DELETE:删除资源
2.restful案例举例
电商网站的订单管理模块。以下是该模块常见的资源及其操作
/orders:获取所有订单列表,创建新订单
/orders/{id}:获取指定订单详情,更新指定订单,删除指定订单
/orders/{id}/items:获取指定订单的商品列表,添加商品到指定订单,从指定订单中删除商品
在以上示例中,URI 中的 orders
和 items
表示订单和商品两种不同的资源,而不同的 HTTP 方法表示不同的操作。
除了符合 RESTful 风格的 URI,为了提高 API 的可用性、可靠性和易用性,我们还应该遵循一些其他的设计规范,例如:
- 使用 HTTP 状态码返回执行结果,通常成功时返回 200 OK,失败时返回相应的错误码;
- 返回 JSON 格式的数据,方便客户端解析和处理;
- 为请求和响应添加必要的头信息,例如 Content-Typ