返回首页 HTTP API 设计指南
关于

基础

隔离关注点
强制使用安全连接（Secure Connections）
强制头信息 Accept 中提供版本号
支持 Etag 缓存
为内省而提供 Request-Id
通过请求中的范围（Range）拆分大的响应

请求（Requests）

返回合适的状态码
提供全部可用的资源
在请求的 body 体使用 JSON 格式数据
使用统一的资源路径格式
路径和属性要小写
支持方便的无 id 间接引用
最小化路径嵌套

响应（Responses）

提供资源的(UU)ID
提供标准的时间戳
使用 UTC（世界标准时间）时间，用 ISO8601 进行格式化
嵌套外键关系
生成结构化的错误
显示频率限制状态
保证响应 JSON 最小化

工件（Artifacts）

可读性
提供可执行的例子
描述稳定性
良好打印的默认 JSON
via 由「UDN技术社区 Wiki」提供

使用 UTC（世界标准时间）时间，用 ISO8601 进行格式化

在接收和返回时都只使用 UTC 格式。ISO8601 格式的数据，例如:

"finished_at": "2012-01-01T12:00:00Z"
上一篇: 提供标准的时间戳 下一篇: 嵌套外键关系