目标

通过本章节介绍可以让开发者通过Swagger对接口在线调试

前置条件

• 在本地通过Application启动工程

操作示例

进入Swagger功能

工程默认8080端口
工程名字：pai-工程名

• 本地默认入口：http://127.0.0.1:8080/doc.html
• 远程部署入口：https://pai.flyrise.cn/工程名-api/doc.html

界面：

通过工程 resources/application.yml 配置swagger

swagger:
  apiTitle: 凌云中台 - 文章管理系统
  description: 凌云中台 - 文章管理系统
  contactName: 吴先生
  contactEmail: wwc@flyrise.cn
  version: 1.0
  pathMapping: /demo-article-api  #在本地环境需要去掉，方便调试

pathMapping: /demo-article-api 在本地环境运行需要注释掉，否则会影响到接口调试

Authorize

进行授权

默认生成代码是需要登录授权才能访问的，否则调用接口提示：

{
  "msg": "401 UNAUTHORIZED 认证失败： 14b69dc5-48e3-4737-8a51-b325c5228d22",
  "code": "401",
  "time": 1647852284953
}

测试账号：

• username： 13012345678
• password： @LinkCloud123
• clientId： web
• clientSecret： 123456

接口调用

1. 确保已授权

如Authorize成功这里还是空的，请关闭接口选项卡，重新打开调试

2. 填写参数

3. 接口返回结果