API de desbloqueio de rede

O Network Unblock é um antifraude recurso que oferece aos usuários a possibilidade de desbloquear por conta própria sua rede bloqueada.

Quando uma rede está bloqueada, a API Verify retorna um erro com o status 7:

{
  "status": "7",
  "error_text": "The network you are trying to verify has been blocked due to possible fraudulent activity",
  "network": "310260"
}

O network O código fornecido na mensagem de erro pode ser usado para desbloquear a rede por meio da API de desbloqueio de rede.

Configuração da conta

A API Network Unblock está disponível para uso tanto com o Verify (Legacy) quanto com o Verify. Para utilizar a API, é necessário que a Account possua o seguinte recurso: verify-allow-network-unblock, que você pode solicitar junto a Vendas. Depois de ter essa funcionalidade atribuída, você poderá usar a API para desbloquear sua rede bloqueada.

Como fazer uma solicitação

A URL do endpoint para sua solicitação de desbloqueio de rede será diferente dependendo da versão da API Verify que você estiver usando:

• Verify (Versão antiga): https://api.nexmo.com/verify/network-unblock
• Verify: https://api.nexmo.com/v2/verify/network-unblock

Sua solicitação deve conter os seguintes parâmetros:

{
  "network": "23410",
  "unblock_duration": "3600"
}

• network contém o código de rede fornecido no erro original.
• unblock_duration é um parâmetro opcional que garante o desbloqueio da rede por um período específico. Seu valor varia de 0 segundos a 86.400 segundos (24 horas).

No exemplo acima, em que unblock_duration Se o tempo for definido em 60 minutos para a rede 23410, essa rede será desbloqueada e terá a garantia de permanecer assim por 60 minutos (mesmo que outro bloqueio venha a ser emitido durante esse período). Após o término da hora, a rede permanecerá desbloqueada, a menos que outro bloqueio seja emitido pelo sistema antifraude devido a atividades fraudulentas.

Se a operação for bem-sucedida, você receberá uma resposta 200 indicando por quanto tempo a rede ficará desbloqueada:

{
  "network": "23410",
  "unblocked_until": "2024-04-22T08:34:58Z"
}