## 服务调用测试
1. 启动`blade-swagger`服务，并打开接口文档系统，开启所有增强配置（新版本开始把swagger网关单独抽离到了`blade-swagger`服务，请单独启动并访问：[http://localhost:18000/doc.html](http://localhost:18000/doc.html)）

   **注⚠️：虽然swagger服务已经独立，但仍然需要开启网关进行服务转发才可以正常访问**

   ![](../../images/screenshot_1611992140441.png)
   ![image-20210227213016171](../../images/image-20210227213016171.png)

   **注⚠️：目前knife4j版本刷新后会丢失增强配置，所以需要手动关闭tab，再重新打开文档页面才会生效**。

   ![image-20210227213135923](../../images/image-20210227213135923.png)

2. 点开Authorize
    ![](../../images/screenshot_1578832659370.png)
    
3. 给`Authorization`和`Tenant-Id`填入对应的值
    ![](../../images/screenshot_1578832729313.png)
    
4. 其中`Authorization`的值是`blade_client`表的`client_id`、`client_secret`字段组合后转换成的Base64编码
    ![](../../images/screenshot_1578832901126.png)
    ![](../../images/screenshot_1578832911878.png)
    
5. 由于Cloud版本使用的是OAuth2(具体说明请看后续专门讲解的章节)，所以找到对应的接口
    ![](../../images/screenshot_1578832549683.png)
    ![](../../images/screenshot_1578832585138.png)
    
6. 框架对密码进行了**二次加密**，由前端调用传参需要现将原密码进行**md5**加密后再进行传递，原密码是`admin`，所以md5加密后是`21232f297a57a5a743894a0e4a801fc3`，具体如下
    ![](../../images/screenshot_1584615713114.png)
    
7. 将原先默认的参数修改为下图,并点击发送，收到返还说明token获取成功
    ![](../../images/screenshot_1584616108432.png)
    
8. 点开`请求头部`，发现我们刚刚设置的两个请求头已经自动带上
    ![](../../images/screenshot_1578833124377.png)




## 错误返回调试
1. 若没有返回正确的token信息，网页如下图进行了弹窗，那就有可能是服务没有启动完整导致的
![](../../images/screenshot_1585303767219.png)
2. 具体进一步排查请看如下帖子：[https://sns.bladex.vip/article-14982.html](https://sns.bladex.vip/article-14982.html)




## 服务鉴权测试
1. 为了测试相关代码，我们到左上角选中`工作台模块`，打开对应的接口文档
![](../../images/screenshot_1578833423102.png)
2. 直接点击调用，发现是鉴权失败
![](../../images/screenshot_1578833404172.png)




## 服务鉴权配置
1. 切换回第一次进行接口调用的token接口，复制对应的两个参数
![](../../images/screenshot_1584616270444.png)
2. 将`token_type`与`access_token`两个值拼接，中间以**空格**隔开，配置到左上角的Authorize内（注意不同子系统切换后，都需要到Authorize模块内配置一下）
![](../../images/screenshot_1578833567083.png)
3. **刷新界面**，**关闭之前的窗口**，再次打开一开始的接口，发现调用成功
![](../../images/screenshot_1578833657716.png)
![](../../images/screenshot_1578833672347.png)




## 后记
* 至此，工程启动成功，api调用成功
* 下一步便是逐步理解整个项目从而可以进入快速开发的阶段