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 se bloquea una red, la API de Verify devuelve un error con el estado 7:

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

El 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 cuenta

La API Network Unblock está disponible tanto para Verify (Legacy) como para Verify. Para poder utilizar la API, es necesario disponer de la siguiente capacidad de Account: verify-allow-network-unblockque puede solicitar a Ventas. Una vez que se te haya asignado esa función, podrás utilizar la API para desbloquear tu 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

Tu solicitud debe incluir 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 la operación se realiza correctamente, recibirás una respuesta 200 en la que se indicará durante cuánto tiempo permanecerá desbloqueada la red:

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