接口文档神器之apidoc
2018-06-22 05:39:36来源:未知 阅读 ()
//@desn:apidoc linux环境 windows环境使用
//@desn:码字不宜,转载请注明出处
//@author:张慧源 <turing_zhy@163.com>
//@date:2018/5/6
正文:
windows版安装:
1.安装nodejs (nodejs环境)
32 位安装包下载地址 : https://nodejs.org/dist/v4.4.3/node-v4.4.3-x86.msi
64 位安装包下载地址 : https://nodejs.org/dist/v4.4.3/node-v4.4.3-x64.msi
2.安装apidoc,
npm install -g apidoc
使用第一个命令版 运行上面的命令安装
linux版安装(ubuntu)
1、更新ubuntu软件源
sudo apt-get update
sudo apt-get install -y python-software-properties software-properties-common
sudo add-apt-repository ppa:chris-lea/node.js
sudo apt-get update
2、安装nodejs
sudo apt-get install nodejs
sudo apt install nodejs-legacy
sudo apt install npm
3、更新npm包镜像源
sudo npm config set registry https://registry.npm.taobao.org
sudo npm config list
4、全局安装n管理器(用于管理nodejs版本)
sudo npm install n -g
5、安装最新的nodejs(stable版本)
sudo n stable
sudo node -v (查看版本)
6、安装apidoc
sudo npm install apidoc -g
使用:以TP框架为例
在网站根目录放上模板 .json
内容:
{
"name": "example",
"version": "0.1.0",
"description": "A basic apiDoc example"
}
这里上个我代码里的注释(apidoc就是把注释转换为接口文档)
/**
* @api {POST} http://aaa.com/index/Index/add_needs 添加用户需求
* @apiVersion 1.0.0
* @apiGroup NEED
*
* @apiParam {String} need_name 需求者名称-非空
* @apiParam {String} e_mail 用户邮箱-非空邮箱格式
* @apiParam {String} phone 用户电话-非空
* @apiParam {String} company_name 需求公司名称-非空
* @apiParam {String} needs_desc 需求描述-非空
*
* @apiSuccess {Object} code 返回码
* @apiSuccess {Object} reason 中文解释
* @apiSuccess {String[]} data 返回数据
*
* @apiSuccessExample {json} Success-Response:
* HTTP/1.1 200 OK
* {
* "code":0,
* "reason":"需求已经提交了,我们的工作人员会在2个工作日内和您取得联系!",
* "data":[]
* }
*/
注释参考:http://apidocjs.com (apidoc官网)
以TP为参考的重点:生成的docapi放在public下
命令:apidoc -i ./ -o ./public/apidoc 注:-i 应用目录 -o 输出apidoc位置 另命令要cd到应用根目录下运行
效果展示:
标签:
版权申明:本站文章部分自网络,如有侵权,请联系:west999com@outlook.com
特别注意:本站所有转载文章言论不代表本站观点,本站所提供的摄影照片,插画,设计作品,如需使用,请与原作者联系,版权归原作者所有
上一篇:PHP多进程消费队列
下一篇:pdo的用处,用法
- PHP网页安全认证的实例详解 2020-01-16
- php调用云片网接口发送短信的实现方法 2019-12-14
- 详解PHP接口继承及接口多继承原理与实现方法 2019-12-13
- PHP实现手机归属地查询API接口实现代码 2019-09-23
- 微信支付H5支付开发文档 2019-07-23
IDC资讯: 主机资讯 注册资讯 托管资讯 vps资讯 网站建设
网站运营: 建站经验 策划盈利 搜索优化 网站推广 免费资源
网络编程: Asp.Net编程 Asp编程 Php编程 Xml编程 Access Mssql Mysql 其它
服务器技术: Web服务器 Ftp服务器 Mail服务器 Dns服务器 安全防护
软件技巧: 其它软件 Word Excel Powerpoint Ghost Vista QQ空间 QQ FlashGet 迅雷
网页制作: FrontPages Dreamweaver Javascript css photoshop fireworks Flash