使用API
学习了如何构建API后,接下来我们学习如何测试和使用API。
API预览
点击右上角"API预览ICON",打开swagger文档页。
左侧为API列表,以文件夹作为分组名,未分组API位于Others分组,此外,还包含FileUpload分组,用于展示OSS对应的路由。
选择对应API,可以查看其Operation,输入入参后,点击“TRY”按钮,可进行测试。响应栏会展示响应状态码和响应结果。
若API需要授权才能访问,需要在右上角选择对应OIDC,进行登录。登录后可查看当前登录用户的基本信息。
此外,若想在POSTMAN等工具测试,点击“下载”按钮,可获取swagger文档。
REST 对接
上述文档展示了所有的API列表,可手工编写任意客户端的代码,对接接口。
SDK生成
除了上述方式外,也可以使用Fireboom生成对应客户端的SDK,提升API对接速度!
若想在客户端使用API,可点击状态栏“客户端模板”,浏览”模板市场“,选择对应”客户端模板“下载,例如TS SDK、Flutter SDK,并配置生成路径。
前往对应路径查看生成的SDK,然后在项目中引用对应语言的客户端SDK,即可使用。
更多详情,前往客户端SDK。
最后更新于