RESTful API 教程|麻瓜教程

RESTful API 教程基于 RFC 官方规范的设计指南

从入门到实战，系统掌握 RESTful API 设计规范

API 设计检查清单

入门篇

什么是 RESTful API、官方规范体系、理查森成熟度模型、REST 六大约束、API 风格对比

核心概念

资源与资源层次、表示与媒体类型、HTTP 方法语义、安全与幂等操作

设计规范

URI 设计规范、版本设计、分页过滤与排序、响应结构与命名、错误处理规范

状态码详解

RFC 9110 全状态码走读、CRUD 场景对照矩阵、高频易混淆状态码辨析

进阶篇

内容协商、缓存与条件请求、认证与授权、批量操作、异步作业、限流与安全

实战与附录

博客系统 API 设计全流程、Spring Boot 实现、API 测试、OpenAPI 工具链、检查清单与速查表

快速导航

什么是 RESTful API - 课程起点：一个请求的旅程
HTTP 方法语义 - GET/POST/PUT/PATCH/DELETE 的规范语义
URI 设计规范 - 资源命名与路径设计的硬性规则
HTTP 状态码详解 - 每个状态码的规范依据与使用场景
错误处理规范 - RFC 9457 Problem Details 标准错误体
博客系统 API 设计 - 从需求到契约的完整实战

学习路径

入门篇（01_入门） - 什么是 RESTful API、REST 的起源与官方规范、理查森成熟度模型、REST 六大约束、API 风格对比
核心概念（02_核心概念） - 资源与资源层次、表示与媒体类型、HTTP 方法语义、安全与幂等操作
设计规范（03_设计规范） - URI 设计规范、版本设计、分页过滤与排序、响应结构与命名、错误处理规范
状态码（04_状态码） - HTTP 状态码详解（RFC 9110 §15 全量走读）
进阶篇（05_进阶） - 内容协商、缓存与条件请求、认证与授权、批量操作设计、异步操作与作业资源、限流与安全规范
实战篇（06_实战） - 博客系统 API 设计、Spring Boot 实现实战、API 测试实战、OpenAPI 文档实战
附录（07_附录） - API 设计检查清单、状态码与媒体类型速查

本教程以 RFC 9110 / 9111 / 9457 / 8259 等官方规范为依据，配合博客系统贯穿案例，帮助你建立"可评审、可落地"的 API 设计规范知识体系。