BarTender Cloud REST API 应用程序类型
问题
哪些类型的应用程序可以对 REST API 发起 RESTful 调用?它们有什么区别?
适用范围
BarTender Cloud REST API
自动化订阅
答案
有两种类型的应用程序可以调用 REST API:
- 控制台应用程序和服务 - 如 Insomnia、Postman、无界面的自定义应用程序
- Web 应用程序 - 自定义或第三方应用程序。
在进行 REST API 调用时,应用程序必须发送令牌并获得授权,API 网关才会处理这些调用。
虽然这两种类型都需要令牌通过安全网关,但获取令牌的方法不同。
测试凭证访问令牌
BarTender Cloud 为您提供了一种快速简便的方式,通过生成临时访问令牌来测试 REST API。您可以按照以下步骤操作:
- 在首页,点击左侧边栏的管理,然后选择API 密钥。
- 点击底部的查看访问令牌。
3. 在弹出的对话框中点击复制访问令牌按钮,并将其粘贴到您的应用程序中。
访问令牌每 10 天过期一次,需要手动刷新。要刷新令牌,请在对话框中点击刷新访问令牌按钮。
Web 应用程序(授权码流程)
Web 应用程序通常使用 C# 等语言开发,具备完整的界面功能。由于这些应用往往是第三方应用,用户可能不愿意直接与其分享账号信息,BarTender Cloud 提供了这种认证方式,让应用程序无需获取用户凭证即可完成认证。这类应用获取令牌的步骤更多,最终通过安全网关进行 API 调用。
关于如何编写自定义 Web 应用以及如何弹出认证对话框,有多个示例可供参考。您可以在我们的 BarTender Cloud 帮助文档中查看更多信息。
控制台应用程序和服务(基于密码)
无法显示 BarTender Cloud 登录对话框的控制台应用程序和服务需要使用基于密码的认证。所有无法显示界面的应用程序都属于此类。此外,这种方式也适用于 Insomnia 或 Postman 等测试工具,因为实现起来更简单。
关于此方法的详细说明,您可以参考以下文章:BarTender Cloud REST API 基于密码的认证。