Deriv API
Documentação

Esquecer tudo

SubscriçãoSem Autenticação

Cancele a subscrição de todos os fluxos de um determinado tipo. Simplificado com menos opções.

Comparação rápida

AspetoLegacy APINew APIAção
Endpointforget_allforget_allNenhum
Autenticação ObrigatóriaNãoNãoNenhum
Tipos de StreamEnum (14 tipos)Qualquer stringNenhum
Campo de RespostaOpcionalObrigatórioAtualizar o tratamento de resposta

Alterações de rutura

1. Validação de enum do tipo de fluxo removida

O Legacy restringia os tipos de fluxo a um enum específico de 14 valores. O New aceita qualquer valor de string, proporcionando mais flexibilidade.

2. Campo de resposta agora obrigatório

No Legacy, o array forget_all na resposta era opcional. Em New, este campo está sempre presente e é obrigatório.

3. Itens do array de resposta agora tipificados

O Legacy definiu forget_all como um array sem especificar tipos de itens. O New define explicitamente os itens do array como strings.

Estrutura de pedido

Legacy APIexemplo de pedido
{
  "forget_all": "ticks"
  // Must be one of 14 enum values
}

// Or multiple types:
{
  "forget_all": ["ticks", "proposal"]
}
New APIexemplo de pedido
{
  "forget_all": "ticks"
  // Any string value accepted
}

// Or multiple types:
{
  "forget_all": ["ticks", "proposal"]
}

Estrutura de resposta

Legacy APIexemplo de resposta
{
  "forget_all": ["sub-id-1", "sub-id-2"],
  // ⚠️ forget_all is optional
  "msg_type": "forget_all"
}
New APIexemplo de resposta
{
  "forget_all": ["sub-id-1", "sub-id-2"],
  // ✓ forget_all is always present
  "msg_type": "forget_all"
}

Exemplos de código

async function forgetAllTicks() {
  const request = {
    forget_all: "ticks"
  };

  ws.send(JSON.stringify(request));

  ws.onmessage = (event) => {
    const response = JSON.parse(event.data);
    if (response.msg_type === 'forget_all') {
      if (response.forget_all) {
        console.log('Unsubscribed from:', response.forget_all.length);
      }
    }
  };
}

Alguma outra questão? Entrar em contacto

Click to open live chat support. Get instant help from our support team.