青年IT男

个人从事金融行业,就职过易极付、思建科技、某网约车平台等重庆一流技术团队,目前就职于某银行负责统一支付系统建设。自身对金融行业有强烈的爱好。同时也实践大数据、数据存储、自动化集成和部署、分布式微服务、响应式编程、人工智能等领域。同时也热衷于技术分享创立公众号和博客站点对知识体系进行分享。微信公众号:青年IT男。

自动更新 Swagger 接口数据到 YApi 平台

自动更新 Swagger 接口数据到 YApi 平台

配置环境

yapi-cli 依赖 Node.js , 请安装不低于 7.6 版本的 Node.js,如果你的机器已经安装了 yapi-cli 工具,且版本号 >= 2.7,可忽略该章节。

安装 Node.js

方案一: 从 Node.js官网下载安装包

方案二: 使用 Node Version Manager(NVM)安装 Node.js,你可以通过以下命令安装 NVM :

cURL:

$ curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.2/install.sh | bash
复制代码

Wget:

$ wget -qO- https://raw.githubusercontent.com/creationix/nvm/v0.33.2/install.sh | bash
复制代码

NVM 安装好以后,重启终端并运行以下命令来安装 Node.js :

nvm install stable
复制代码

使用 NPM 安装 yapi-cli

请确保 yapi-cli 工具版本 >= 1.2.7。

npm install yapi-cli [-g]
复制代码

使用方法

该功能可在任意一台机器使用,只需确保该机器能够连接到部署的 YApi 网站。

第一步:新建配置文件

在任意一个目录下新建配置文件 yapi-import.json,内容如下:

{
  "type": "swagger",
  "token": "17fba0027f300248b804",
  "file": "http://127.0.0.1:18091/v2/api-docs",
  "merge": "good",
  "server": "http://yapi.local.qunar.com:3000"
}
复制代码

type是数据数据方式,目前官方只支持 swagger

token是项目token,在 项目设置 -> token设置获取

file是 swagger 接口文档文件,可使用绝对路径或 url

merge导入旧的接口策略,默认使用智能模式,一共有 “normal”(普通模式) , “good”(智能合并), “merge”(完全覆盖) 三种模式

server是yapi服务器地址

第二步,执行导入命令

新建配置文件的当前目录,执行下面指令就能把数据导入到 yapi 接口管理平台。

yapi import
复制代码

如果提示找不到 yapi命令,可尝试执行 yapi-cli,因为部分系统环境不兼容。

自动更新

配合 crontab 这类定时任务执行工具,就可以实现自动更新接口数据,相信聪明的你一定能搞定。

0
青年IT男

个人从事金融行业,就职过易极付、思建科技等重庆一流技术团队,目前就职于某网约车平台负责整个支付系统建设。自身对金融行业有强烈的爱好。同时也实践大数据、数据存储、自动化集成和部署、分布式微服务、响应式编程、人工智能等领域。

评论已关闭。

This site is protected by wp-copyrightpro.com