REST+JSON API设计指南.pdfVIP

下载本文档

85
0
约7.34千字
约 35页
2017-09-17 发布于湖北
举报
版权申诉

REST+JSON API设计指南.pdf

1、有哪些信誉好的足球投注网站（book118）网站文档一经付费（服务费），不意味着购买了该文档的版权，仅供个人/单位学习、研究之用，不得用于商业用途，未经授权，严禁复制、发行、汇编、翻译或者网络传播等，侵权必究。。
2、本站所有内容均由合作方或网友上传，本站不对文档的完整性、权威性及其观点立场正确性做任何保证或承诺！文档内容仅供研究参考，付费前请自行鉴别。如您付费，意味着您自己接受本站规则且自行承担风险，本站不退款、不进行额外附加服务；查看《如何避免下载的几个坑》。如果您已付费下载过本站文档，您可以点击这里二次下载。
3、如文档侵犯商业秘密、侵犯著作权、侵犯人身权等，请点击“版权申诉”（推荐），也可以打举报电话：400-050-0827(电话支持时间：9:00-18:30)。
4、该文档为VIP文档，如果想要下载，成为VIP会员后，下载免费。
5、成为VIP后，下载本文档将扣除1次下载权益。下载后，不支持退款、换文档。如有疑问请联系我们。
6、成为VIP后，您将拥有八大权益，权益包括：VIP文档下载权益、阅读免打扰、文档格式转换、高级专利检索、专属身份标志、高级客服、多端互通、版权登记。
7、VIP文档为合作方或网友上传，每下载1次，网站将根据用户上传文档的质量评分、类型等，对文档贡献者给予高额补贴、流量扶持。如果你也想贡献VIP文档。上传文档

RESTJSONAPI设计指南

REST+JSON API设计指南 Thomas 2015‐12‐25 主要内容 •API ，REST和JSON • 内容协商 • 方法重载 •REST基础 • 资源引用 • 资源扩展 •设计要素 • 分页 • 部分响应 • 基础URL • 查询参数 • 缓存与Etag • 版本 • 关联 • 安全 • 资源格式 • 错误码 • 多租户 • 返回码 • ID • 维护为何要使用REST？ •可扩展性 •通用型 •独立性 •延迟 •安全 •封装为何要使用JSON • 随处可见 • 简单 •可读 •可扩展 • 灵活 HATEOAS •Hypermedia •As •The •Engine •Of •Application •State 资源 •使用名词，不使用动词 •粗粒度，而不是细粒度 • 为了用例扩展，采用架构式风格不是这样的！ •/getAccount •/createDirectory •/updateGroup •/verifyAccountEmailAddress 使用两类资源 • 集合类资源 • /applications • 实例资源 • /applications/abc123 行为 •GET = Read •PUT = Create, 指定资源ID ，完全更新，是幂等操作 •POST = Create集合中的新资源（201），对某个资源则是更新操作(200）, 不是幂等操作 •DELETE = Delete •HEAD = Headers ，no Body 媒体类型 •格式规范+解析规则 • 请求：使用Accept 头 • 响应：使用Content‐Type 头 • application/json • application/foo+json • application/foo+json;application • … 设计一：基础URL •http(s):// vs /dev/service/api/rest •https(s):// Rest客户端vs 浏览器设计二：版本 •URL • /v1 •Media‐Type • application/foo+json;applicationv=1 设计三：资源类型 •Content‐Type ：application/json •如果时间允许的话： • ap