Netzwerk Entsperren API

Network Unblock ist ein Betrugsbekämpfung die den Nutzern eine Selbstbedienungsmöglichkeit bietet, um ihr blockiertes Netz freizugeben.

Wenn ein Netzwerk blockiert ist, kehrt die Verify-API mit einem Fehler des Status 7 zurück:

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

Die network Der in der Fehlermeldung angegebene Code kann verwendet werden, um das Netzwerk über die Network Unblock API zu entsperren.

Account einrichten

Die Netzwerkfreigabe-API kann sowohl mit Verify (Legacy) als auch mit Verify verwendet werden. Um die API nutzen zu können, müssen Sie über die Account-Fähigkeit verfügen: verify-allow-network-unblockdie Sie anfordern können bei Vertrieb. Sobald Sie diese Fähigkeit zugewiesen haben, können Sie die API verwenden, um Ihr blockiertes Netzwerk zu entsperren.

Einen Antrag stellen

Die Endpunkt-URL für Ihre Anfrage zur Aufhebung der Netzwerksperre ist unterschiedlich, je nachdem, welche Version der Verify-API Sie verwenden:

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

Ihre Anfrage sollte die folgenden Parameter enthalten:

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

• network enthält den im ursprünglichen Fehler angegebenen Netzcode.
• unblock_duration ist ein optionaler Parameter, der eine Netzfreigabe für einen bestimmten Zeitraum garantiert. Er reicht von 0 Sekunden bis 86.400 Sekunden (24 Stunden).

Im obigen Beispiel, wo unblock_duration für das Netz 23410 auf 60 Minuten eingestellt ist, wird dieses Netz freigegeben und bleibt garantiert 60 Minuten lang gesperrt (auch wenn in dieser Zeit eine weitere Sperrung erfolgen könnte). Nach Ablauf der Stunde bleibt das Netz entsperrt, es sei denn, es wird vom Betrugsbekämpfungssystem eine weitere Sperre aufgrund von betrügerischen Aktivitäten verhängt.

Bei Erfolg erhalten Sie eine 200er-Antwort, die angibt, wie lange das Netz freigegeben ist:

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