使用API

学习了如何构建API后，接下来我们学习如何测试和使用API。

API预览

点击右上角"API预览ICON"，打开swagger文档页。

预览页

左侧为API列表，以文件夹作为分组名，未分组API位于Others分组，此外，还包含FileUpload分组，用于展示OSS对应的路由。

选择对应API，可以查看其Operation，输入入参后，点击“TRY”按钮，可进行测试。响应栏会展示响应状态码和响应结果。

若API需要授权才能访问，需要在右上角选择对应OIDC，进行登录。登录后可查看当前登录用户的基本信息。

此外，若想在POSTMAN等工具测试，点击“下载”按钮，可获取swagger文档。

REST 对接

上述文档展示了所有的API列表，可手工编写任意客户端的代码，对接接口。

值得注意的是，对于GET请求的对象入参，要用JSON字面量的方式传入，详情参考 路由规则

SDK生成

除了上述方式外，也可以使用Fireboom生成对应客户端的SDK，提升API对接速度！

若想在客户端使用API，可点击状态栏“客户端模板”，浏览”模板市场“，选择对应”客户端模板“下载，例如TS SDK、Flutter SDK，并配置生成路径。

前往对应路径查看生成的SDK，然后在项目中引用对应语言的客户端SDK，即可使用。

更多详情，前往客户端SDK。