Introduction
基础
隔离关注点
需要安全连接
在 Accepts 标头中要求版本控制
支持 ETags 缓存
为自省提供请求 ID
在具有范围的请求之间划分大响应
请求
在请求体中接受序列化的 JSON
资源名称
操作
使用一致的路径格式
小写路径和属性
为方便起见,支持非id间接引用
最小化路径嵌套
响应
返回适当的状态代码
在可用的情况下提供完整资源
提供资源(UU)ID
提供标准时间戳
提供标准响应类型
使用ISO8601格式的UTC时间
嵌套外键关系
生成结构化错误
显示速率限制状态
在所有响应中保持 JSON 缩小
工件
提供机器可读的 JSON 模式
提供人类可读的文档
提供可执行示例
描述稳定性
本书使用 GitBook 发布
提供机器可读的 JSON 模式
提供机器可读的 JSON 模式
提供机器可读的模式来准确指定您的 API。使用
prmd
来管理您的架构,并确保它使用了
prmd verify
验证。
results matching "
"
No results matching "
"