API de déblocage du réseau

Network Unblock est un lutte contre la fraude qui permet aux utilisateurs de débloquer leur réseau en libre-service.

Lorsqu'un réseau est bloqué, l'API Verify renvoie une erreur d'état 7 :

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

Les network fourni dans l'erreur peut être utilisé pour débloquer le réseau via l'API de déblocage du réseau.

Configuration du compte

L'API de déblocage du réseau peut être utilisée avec Verify (ancienne version) et Verify. Pour utiliser l'API, vous devez disposer de la capacité de compte : verify-allow-network-unblockque vous pouvez demander à Vente. Une fois cette capacité attribuée, vous pouvez utiliser l'API pour débloquer votre réseau bloqué.

Faire une demande

L'URL du point d'arrivée de votre demande de déblocage du réseau sera différente selon la version de l'API Verify que vous utilisez :

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

Votre demande doit contenir les paramètres suivants :

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

• network contient le code de réseau fourni dans l'erreur initiale.
• unblock_duration est un paramètre facultatif qui garantit le déblocage du réseau pendant une période donnée. Il est compris entre 0 seconde et 86 400 secondes (24 heures).

Dans l'exemple ci-dessus, où unblock_duration est fixé à 60 minutes pour le réseau 23410, ce réseau sera débloqué et garantira de le rester pendant 60 minutes (même si un autre blocage peut être émis pendant cette période). Une fois l'heure écoulée, le réseau restera débloqué, sauf si le système antifraude émet un autre blocage en raison d'une activité frauduleuse.

En cas de succès, vous recevrez une réponse 200 indiquant la durée de déblocage du réseau :

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