raml 的使用

场景.使用raml构建接口文档

1.安装能够将raml 转化为 html 文件的 raml2html工具 安装步骤如下

npm i -g raml2html

2.将编辑好的raml文件生成html文件以便查阅

raml2html test.v1.raml > test.v1.html

3.下载mock服务以便能够通过http服务访问接口

    如果在下载过程中出错诸如（rollbackFailedOptional: verb npm-session），可以使用如下代理

npm config set registry http://registry.npmjs.org/ 

3.1下载服务设置

npm install -g osprey-mock-service

3.2 运行指定的raml文件并设置访问端口

osprey-mock-service -f stock.v1.raml -p 8089

4.测试 假设 raml文件中包含如下路径信息

http://127.0.0.1:8089/recommend/find

在浏览器中访问可获取到相应的返回值