跳转至

WebView 插件 SDK vs Open API

在为 WebView 插件构建 Web 应用程序时,开发人员可以使用 WebView 插件 SDKOpen API 或同时使用两者,以实现其网页服务与 cTrader 平台之间的通信。 本指南将帮助您了解何时使用每种工具。

概述

WV 插件 SDK 和 Open API 都提供了强大的功能,但它们在作用范围、信任模型和允许的操作方面有不同用途。

属性 WV 插件 SDK Open API
使用上下文 内部的并嵌入 cTrader 中。
用于 WebView 插件的网页应用程序。
外部公开,不绑定任何特定流程。
可由任何服务使用。
身份验证 在 cTrader 内部自动完成身份验证。 需要额外的身份验证或 OAuth 2.0 令牌。
权限 包括敏感操作在内的完整功能。 仅限于非敏感数据。
性能 过多的请求量可能会影响插件的运行。 可扩展以支持大量数据查询与聚合。

共享功能

对于 WebView 插件,某些功能可以通过 WV 插件 SDKOpen API 实现。 您可以使用任一方式执行以下操作:

  • 获取历史数据
  • 获取交易品种信息
  • 订阅报价
  • 检索账户数据(余额和净值)。

使用 WV 插件 SDK 实现账户数据检索,可实现无缝操作:

  • 无需用户提供令牌。

  • 无需单独的登录流程。

  • 认证由 cTrader 自动处理。

当您的网页应用程序作为 WebView 插件在 cTrader 内部运行时,它会继承用户的已认证会话。 这种设置使得账户数据检索更快、更安全且对用户更友好。

注意

WV 插件 SDK 使开发人员能够完全使用前端技术(JavaScript、HTML 和 CSS)为 WebView 插件创建网页应用程序,或者使用 AI 创建 WV 插件。 您无需实现或维护后端服务。

在您的网页应用程序中使用 Open API 实现账户数据检索,意味着需要满足以下一项或多项要求:

  • 您必须在应用程序中实现 OAuth 2.0 授权流程。

  • 交易者必须登录 cTrader 并授权您的应用程序。

  • 交易者必须生成并提供个人访问令牌。

警告

虽然 Open API 也支持检索某些账户数据,但对于 WV 插件开发人员而言,它存在一些限制。 额外的认证步骤增加了开发复杂度,破坏用户体验,并可能阻碍产品的推广与使用。

关键差异

网页应用程序可以使用 WV 插件 SDK 在 cTrader 中执行各种交易操作,而 Open API 并不支持 WebView 插件执行这些功能。

WV 插件操作 WV 插件 SDK Open API
创建新订单
修改现有订单
取消订单
平仓
修改止损/止盈保护
切换界面

警告

WebView 插件在操作时不会访问或传输任何个人用户信息,例如用户名或账户标识符。 虽然插件在 cTrader 环境中主动连接时可以访问有限的账户数据(例如余额),但它们在任何时候都不会存储 cookie。

cTrader 将敏感操作限制在平台环境中执行,其中:

  • 用户已明确安装或启用了插件。

  • 平台可以强制执行额外的确认流程。

  • 在发送请求之前,头寸限制、保证金检查和风险规则会在本地运行。

使用 Open API 的外部网站无法提供相同级别的控制与安全保障;因此,禁止在该环境中暴露与交易相关的接口。

总结

在用于构建 WebView 插件的网页应用程序中使用 WV 插件 SDK,特别是当网页应用程序需要进行交易或处理某些账户数据时。

在 cTrader 外部运行并依赖公共数据的网页应用程序中使用 Open API。