当前，作为大部分移动app和云服务后台之间的标准连接方式，REST API已经得到了绝大部分开发者的认可和广泛的应用。近年来，在新兴API经济模式逐渐兴起，许多厂商纷纷将自己的后台业务能力作为REST API开放出来，给更广泛的第三方开发者使用。
但是，管理REST API并非是一件容易的工作。由于缺乏有效的接口数据schema约束，加上设计REST API时resource endpoint的安排，以及发送http请求的方式又都五花八门，REST API开发完成后，大多数情况下API开发者仍然需要手动书写API文档，让用户能按照文档的说明接入。并且在API发生变化时需要重写文档，这个过程费时费力而且容易出错。比如，一个REST API文档最少必须列明以下的基本信息：
* API的名称
* API所在的URL资源路径
* http请求方法（GET, POST, PUT等）
* API提交数据的方式（查询参数、表单提交、JSON提交等）
* 调用API返回数据的格式
在上面提供的REST API信息中，从API返回的JSON数据在大部分情况下甚至只能用“举例”的方法说明数据的结构，而无法精确表达出这段JSON数据中每个字段的精确含义和类型定义。这都是因为REST API缺少对JSON数据的schema定义而
延伸阅读
- ssh框架 2016-09-30
- 阿里移动安全 [无线安全]玩转无线电——不安全的蓝牙锁 2017-07-26
- 消息队列NetMQ 原理分析4-Socket、Session、Option和Pipe 2024-03-26
- Selective Search for Object Recognition 论文笔记【图片目标分割】 2017-07-26
- 词向量-LRWE模型-更好地识别反义词同义词 2017-07-26
- 从栈不平衡问题 理解 calling convention 2017-07-26
- php imagemagick 处理 图片剪切、压缩、合并、插入文本、背景色透明 2017-07-26
- Swift实现JSON转Model - HandyJSON使用讲解 2017-07-26
- 阿里移动安全 Android端恶意锁屏勒索应用分析 2017-07-26
- 集合结合数据结构来看看(二) 2017-07-26
学习是年轻人改变自己的最好方式