Deriv API
Documentação

Esquecer

SubscriçãoSem Autenticação

Cancele imediatamente o fluxo de mensagens em tempo real com um ID específico.

Comparação rápida

AspetoLegacy APINew APIAção
EndpointforgetforgetNenhum
Autenticação ObrigatóriaNãoNãoNenhum
Padrão de ID de StreamRigorosoQualquer stringNenhum
Campo de RespostaOpcionalObrigatórioAtualizar o tratamento de resposta

Alterações de rutura

1. Validação de padrão de ID de stream relaxada

Legacy enforced a strict pattern ^[\w-]{32,128}$ for stream IDs. New accepts any string value, providing more flexibility.

2. Campo de resposta sempre presente

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

Estrutura de pedido

Legacy APIexemplo de pedido
{
  "forget": "d1ee7d0d-3ca9-fbb4-720b-5312d487185b"
}
New APIexemplo de pedido
{
  "forget": "d1ee7d0d-3ca9-fbb4-720b-5312d487185b"
}

Estrutura de resposta

Legacy APIexemplo de resposta
{
  "forget": 1,  // Optional field
  "msg_type": "forget"
}
New APIexemplo de resposta
{
  "forget": 1,  // ⚠️ Now required
  "msg_type": "forget"
}

Exemplos de código

async function cancelStream(streamId) {
  const request = {
    forget: streamId
  };

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

  ws.onmessage = (msg) => {
    const response = JSON.parse(msg.data);
    if (response.msg_type === 'forget') {
      if (response.forget === 1) {
        console.log('Stream successfully cancelled');
      }
    }
  };
}
Click to open live chat support. Get instant help from our support team.