前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >API可视化管理平台YApi

API可视化管理平台YApi

作者头像
Ryan-Miao
发布2020-10-23 16:22:21
1.7K0
发布2020-10-23 16:22:21
举报
文章被收录于专栏:Ryan Miao

Yapi是什么

YApi 是高效、易用、功能强大的 api 管理平台,旨在为开发、产品、测试人员提供更优雅的接口管理服务。可以帮助开发者轻松创建、发布、维护 API,YApi 还为用户提供了优秀的交互体验,开发人员只需利用平台提供的接口数据写入工具以及简单的点击操作就可以实现接口的管理。

我主要使用方式如下:

  • 项目集成swagger, 接口添加api注解
  • 导出api-docs.json
  • YApi导入api-docs.json

那么,既然swagger有了为啥还要多做一步导入YApi呢。因为YApi有更友好的查看管理,结合测试,可以有效表现api定义和示例。

另外,有的项目无法对外提供swagger接口,受环境限制。swagger也不适合多个项目的api管理。

后端定义好api结构,然后导入YApi, 在测试里输入样例参数,直接丢给前端即可完全实现前后端分离,有效提高api对接联调速度。

Yapi安装

官方地址: https://github.com/YMFE/yapi/

也可以通过docker安装 https://github.com/Ryan-Miao/docker-yapi

关于插件:加入一些登录插件,比如cas,需要编译client, 执行

代码语言:javascript
复制
npm install && npm run build-client

这时候, 官方源码会报错,主要是babel插件和eslink错误。见 https://github.com/YMFE/yapi/pull/1937

账号管理和权限

可以配置邮箱注册后缀,只允许公司内部用户邮箱注册。 也可以接入sso插件,接入公司的LDAP或者SSO,CAS等, 统一管理用户。

与Swagger集成

与swagger集成有两种方式, 一种是手动导入api-docs.json, 这种方式适用于yapi和api服务网络不通,只能手动维护的情况。

另一个就是在线自动同步,只要填入swagger的地址就可以了。

我们导入swagger官方示例: https://petstore.swagger.io/v2/swagger.json

查看接口定义

根据swagger定义的参数和返回值对象,yapi对应都有解析到。

执行接口

点击运行, 和swagger postman一样,可以直接执行接口。

这里有个问题,前后端分离后,接口鉴权通常是通过header传递token实现的。官方默认实现没有提供自定义header的功能。还有yapi架构设计很好,开源,有很多插件可以参考。

比如: https://github.com/shouldnotappearcalm/yapi-plugin-interface-oauth2-token

具体用法见: https://blog.csdn.net/shouldnotappearcalm/article/details/104726505

保存执行结果

刚才运行的接口点击保存,我们的参数就保存下来了。后面直接告诉前端同学地址,他可以通过测试用例来调用api。

测试用例

yapi相比swagger另一个比较好的功能就是测试和mock。先不说mock,就说测试api,后端开发好api后, 还要告诉前端怎么调用。有时候, 数据库的数据有限,还要告诉前端哪些参数可用,可以跳通。这些可以通过yapi运行接口后保存为测试实例来完成。

本文参与 腾讯云自媒体同步曝光计划,分享自作者个人站点/博客。
原始发表:2020-10-11 ,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 作者个人站点/博客 前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体同步曝光计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • Yapi是什么
  • Yapi安装
  • 账号管理和权限
  • 与Swagger集成
    • 查看接口定义
      • 执行接口
        • 保存执行结果
        • 测试用例
        相关产品与服务
        容器服务
        腾讯云容器服务(Tencent Kubernetes Engine, TKE)基于原生 kubernetes 提供以容器为核心的、高度可扩展的高性能容器管理服务,覆盖 Serverless、边缘计算、分布式云等多种业务部署场景,业内首创单个集群兼容多种计算节点的容器资源管理模式。同时产品作为云原生 Finops 领先布道者,主导开源项目Crane,全面助力客户实现资源优化、成本控制。
        领券
        问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档