API de desbloqueo de red

Network Unblock es un lucha contra el fraude que ofrece a los usuarios un autoservicio para desbloquear su red bloqueada.

Cuando una red está bloqueada, la API Verify devuelve un error de estado 7:

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

En network proporcionado en el error puede utilizarse para desbloquear la red a través de la API de desbloqueo de red.

Configuración de la Account

La API de desbloqueo de red está disponible tanto para Verify (heredado) como para Verify. Para poder utilizar la API, debe disponer de la capacidad Account: verify-allow-network-unblockque puede solicitar a Ventas. Una vez que tenga asignada esa capacidad, podrá utilizar la API para desbloquear la red bloqueada.

Realizar una solicitud

La URL del punto final para su solicitud de desbloqueo de red será diferente dependiendo de la versión de la API de Verify que esté utilizando:

• Verify (Legacy): https://api.nexmo.com/verify/network-unblock
• Verify: https://api.nexmo.com/v2/verify/network-unblock

Su solicitud debe contener los siguientes parámetros:

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

• network contiene el código de red proporcionado en el error original.
• unblock_duration es un parámetro opcional que garantizará el desbloqueo de la red durante un periodo de tiempo específico. Oscila entre 0 segundos y 86.400 segundos (24 horas).

En el ejemplo anterior, donde unblock_duration se establece en 60 minutos para la red 23410, esa red se desbloqueará y se garantizará que permanecerá así durante 60 minutos (aunque se emita otro bloqueo durante ese tiempo). Una vez finalizada la hora, la red permanecerá desbloqueada a menos que el sistema antifraude emita otro bloqueo debido a una actividad fraudulenta.

Si tiene éxito, recibirá una respuesta 200 indicando durante cuánto tiempo estará desbloqueada la red:

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