ネットワーク・ブロック解除API

ネットワーク・アンブロックは 詐欺防止 この機能は、ブロックされたネットワークのブロックを解除するセルフサービス機能をユーザーに提供する。

ネットワークがブロックされると、Verify APIはステータス7のエラーを返す：

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

について network エラーで提供されたコードは、Network Unblock APIを介してネットワークのブロックを解除するために使用することができます。

アカウント設定

Network Unblock API は、Verify (Legacy) と Verify の両方で使用できます。API を使用するには、アカウント機能が必要です： verify-allow-network-unblockにリクエストすることができる。 売上高.この機能が割り当てられると、APIを使ってブロックされたネットワークのブロックを解除することができる。

リクエスト

Network UnblockリクエストのエンドポイントURLは、使用しているVerify APIのバージョンによって異なります：

• Verify（レガシー）： https://api.nexmo.com/verify/network-unblock
• Verify： https://api.nexmo.com/v2/verify/network-unblock

リクエストには以下のパラメータを含める必要があります：

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

• network には、元のエラーで指定されたネットワーク・コードが含まれている。
• unblock_duration はオプションのパラメータで、特定の期間、ネットワークのブロック解除を保証する。範囲は0秒から86,400秒（24時間）です。

上記の例では unblock_duration がネットワーク23410の60分に設定されている場合、そのネットワークはブロック解除され、60分間はその状態が保証されます（その間に別のブロックが発行される可能性があっても）。時間経過後、不正行為のために不正防止システムによって別のブロックが発行されない限り、ネットワークはブロックされないままです。

成功した場合、ネットワークがブロックされなくなる時間を示す200応答が返ってきます：

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