该技能面向分布式超媒体系统的 REST 架构风格,基于无状态、客户端—服务器、可缓存的 HTTP 通信。适用场景包括:构建面向第三方开发者、Webhook 与合作伙伴集成的开放公共 API;借助 Cache-Control、ETag、Last-Modified 等响应头提升可缓存性与 CDN 优化;设计资源导向的 CRUD 资源层级;以及提供任何 HTTP 客户端均可消费的无状态集成。
核心概念涵盖 HTTP 方法的幂等性与安全性:GET 安全且幂等,POST 均否,PUT 幂等,PATCH 依情况,DELETE 幂等。错误表示建议遵循 RFC 7807/9457,返回 application/problem+json,包含 type、title、status、detail、instance。内容协商与 ETag 缓存可通过 If-None-Match 判断缓存是否新鲜并返回 304,避免重传完整负载。分页推荐基于单调游标(如 created_at + id)替代 OFFSET,避免性能退化与并发写入跳项,响应含 data 与 pagination(hasMore、nextCursor)。
最佳实践:资源 URI 使用名词(如 /api/v1/orders);对变更请求使用 Idempotency-Key 头防重复扣款;以 OpenAPI 3.1 生成文档、SDK 与校验模式;大数据集用游标分页。避免以 HTTP 200 返回 { "error": ... },应使用正确的 400、401、403、404、422、500;破坏性变更需版本化(如 /v1/ 前缀或头版本);不要暴露内部数据库列名。常见故障包括 405(方法不允许)、415(媒体类型不支持,应设 Content-Type: application/json)与 CORS 错误(需服务端设置 Access-Control-Allow-Origin)。参考资料列出 Microsoft RESTful API Design 与 Richardson Maturity Model。具体安装命令、收费与价格信息暂未提供。