SDK de plugins WebView vs Open API¶
Quando desenvolvem aplicações web para plugins WebView, os programadores podem usar o WebView plugin SDK, a Open API ou ambos para permitir a comunicação entre os seus serviços web e a plataforma cTrader. Este guia irá ajudá-lo a compreender quando usar cada um.
Visão Geral ¶
Tanto o SDK de plugins WV como a Open API oferecem capacidades poderosas, mas têm finalidades diferentes em termos de âmbito, modelo de confiança e operações permitidas.
| Atributo | SDK de plugins WV | Open API |
|---|---|---|
| Contexto de utilização | Interno e incorporado no cTrader. Utilizado em aplicações web para plugins WebView. | Externo e público, não vinculado a nenhum fluxo específico. Pode ser utilizado por qualquer serviço. |
| Autenticação | Automaticamente autenticado dentro do cTrader. | Requer autenticação adicional ou tokens OAuth 2.0. |
| Permissões | Capacidades totais, incluindo para operações sensíveis. | Limitado a dados não sensíveis. |
| Desempenho | Volumes excessivos de pedidos podem afetar o plugin. | Dimensiona para consultas e agregação de grandes volumes de dados. |
Capacidades partilhadas ¶
Para plugins WebView, algumas funcionalidades estão disponíveis através do SDK de plugins WV e da Open API. Pode usar qualquer um deles para fazer o seguinte:
- Obter dados históricos
- Obter informações sobre símbolos
- Subscrever cotações
- Recuperar dados da conta (saldo e capital).
A implementação da recuperação de dados da conta usando o SDK de plugins WV significa operações perfeitas:
-
Não é necessário token do utilizador.
-
Não é necessário um fluxo de login separado.
-
A autenticação é tratada automaticamente pela cTrader.
Quando a sua aplicação web é executada dentro do cTrader como um plugin WebView, herda a sessão autenticada do utilizador. Esta configuração torna a recuperação de dados da conta mais rápida, mais segura e mais fácil de usar.
Nota
O SDK de plugins WV permite que os programadores criem aplicações web para plugins WebView inteiramente com tecnologias frontend (JavaScript, HTML e CSS), ou criem plugins WV com IA. Não seria necessário implementar ou manter um serviço backend.
A implementação da recuperação de dados da conta usando a Open API na sua aplicação web significa uma ou mais das seguintes opções:
-
Deve implementar um fluxo OAuth 2.0 na sua aplicação.
-
Os traders devem fazer login no cTrader e autorizar a sua aplicação.
-
Os traders devem gerar e fornecer um token de acesso pessoal.
Aviso
Embora a Open API também suporte a recuperação de determinados dados da conta, existem limitações para os programadores de plugins WV. O passo extra de autenticação complica o desenvolvimento, prejudica a experiência do utilizador e pode desencorajar a adoção do seu produto.
Principais diferenças ¶
As aplicações web podem executar várias ações de negociação no cTrader usando o SDK de plugins WV, enquanto a Open API não suporta estas funcionalidades para plugins WebView.
| Operação do plugin WV | SDK de plugins WV | Open API |
|---|---|---|
| Criar novas ordens | Sim | Não |
| Modificar ordens existentes | Sim | Não |
| Cancelar ordens | Sim | Não |
| Fechar posições | Sim | Não |
| Modificar proteção SL/TP | Sim | Não |
| Navegar entre ecrãs | Sim | Não |
Aviso
Os plugins WebView funcionam sem aceder ou transferir quaisquer informações pessoais dos utilizadores, como nomes de utilizador ou identificadores de conta. Embora os plugins possam aceder a dados limitados da conta (por exemplo, saldo) quando ativamente ligados no ambiente cTrader, não armazenam cookies em nenhum momento.
O cTrader limita as operações sensíveis ao ambiente da plataforma, onde:
-
O utilizador instalou ou ativou explicitamente o plugin.
-
A plataforma pode impor fluxos de confirmação adicionais.
-
Os limites de posição, verificações de margem e regras de risco são executados localmente antes do envio do pedido.
Um website externo que utilize a Open API não pode garantir o mesmo nível de controlo e segurança; por conseguinte, os parâmetros relacionados com negociação não podem ser expostos aí.
Resumo ¶
Use o SDK de plugins WV em aplicações web que serão usadas para criar um plugin WebView, especialmente se a aplicação web precisar de negociar ou lidar com determinados dados da conta.
Use a Open API em aplicações web que funcionam fora do cTrader e dependem de dados públicos.