ネットワークレジストリAPI

に詳述されている承認申請プロセス。 ネットワーク・レジストリ ガイドをプログラムで管理することもできます。 ネットワークレジストリAPI.これにより、承認プロセスの自動化が可能になる。

APIリファレンス

ネットワークレジストリAPIのOpenAPI仕様は以下の通り。 これ.

認証

認証はあなたの APIキー そして APIシークレットにある。 開発者ダッシュボード.

ビジネス・プロファイルの管理

を使用して、ビジネス・プロファイルを作成、取得、削除できます。 /business-profile エンドポイントである。

次の例は、「My business profile」という新しいビジネスプロファイルを作成する

POST
リクエストで、スペインとドイツのオペレータへのアクセスを要求している。呼び出しの本文には、Network Registryダッシュボードが要求するのと同じ情報(役割、国、税番号など)が含まれる:

curl -X POST "http://api-eu.vonage.com/v1/network-registry/business-profiles" \
-H "Content-Type: application/json" \
-u ${API_Key}:${API_Password} \
-d '{
   "countries": [
      "ES",
      "DE"
   ],
   "contact_role": "A Business Profile",
   "name": "A Business Profile",
   "trading_name": "A Business Profile Ltd.",
   "organization_type": "forProfitOrganization",
   "tax_number": "98284687G",
   "business_registration_id": "15-048-3782",
   "issuing_authority": "National Government",
   "privacy_policy_url": "https://www.businessinc.com/privacy_policy",
   "privacy_policy_manager_email": "privacy.manager@business.com",
   "dpo_email": "dpo@business.com",
   "dpo_required": true,
   "terms_and_conditions_accepted": true,
   "business_information": {
      "address_street_1": "Main Street 5",
      "address_street_2": "Extra long address",
      "postal_code": "W1 5DU",
      "country": "ES",
      "city": "London",
      "province": "City of London"
   },
   "email_notifications_enabled": true,
   "vetting_terms_and_conditions_accepted": true,
   "vetting_extra_fields": {
      "tax_number_type": "NIF",
      "duns_number": "123456789"
   }
}'

ビジネス・プロファイルを変更するには、以下を使用して

PUT
リクエストを送信する。 /change-request とあなたのビジネスプロフィールのIDを入力してください:

curl -X PUT "http://api-eu.vonage.com/v1/network-registry/business-profiles/$BUSINESS-PROFILE-ID/change-request" \
-H "Content-Type: application/json" \
-u ${API_Key}:${API_Password} \
-d '{
   "countries": [
      "ES"
   ],
   "contact_role": "A Business Profile",
   "name": "A Business Profile",
   "trading_name": "A Business Profile Ltd.",
   "organization_type": "For-Profit Organization",
   "tax_number": "98284687G",
   "business_registration_id": "15-048-3782",
   "issuing_authority": "National Government",
   "privacy_policy_url": "https://www.businessinc.com/privacy_policy",
   "privacy_policy_manager_email": "privacy.manager@business.com",
   "dpo_email": "dpo@business.com",
   "dpo_required": true,
   "terms_and_conditions_accepted": true,
   "business_information": {
      "address_street_1": "Main Street 5",
      "address_street_2": "Extra long address",
      "postal_code": "W1 5DU",
      "country": "ES",
      "city": "London",
      "province": "City of London"
   },
   "email_notifications_enabled": true,
   "vetting_terms_and_conditions_accepted": true,
   "vetting_extra_fields": {
      "tax_number_type": "NIF",
      "duns_number": "123456789"
   }
}'

すべての操作とパラメーターの完全なリストは APIリファレンス.

アプリケーションプロファイルの管理

について /application-profiles エンドポイントを使用して、アプリケーション・プロファイルに関連するすべての操作を実行できます。この例では、新しいアプリケーション・プロファイルを作成するために

POST
リクエストを送信します:

curl -X POST "http://api-eu.vonage.com/v1/network-registry/application-profiles" \
-H "Content-Type: application/json" \
-u ${API_Key}:${API_Password} \
-d '{
   "business_profile_id": "2hothFWw2ssb3y3lhh5Fu3tzfqV",
   "name": "Network Application Profile",
   "description": "This Network Application Profile main use case is for Fraud Prevention",
   "category_id": "finance",
   "network_apis": [
      {
         "network_api_id": "sim-swap",
         "purpose_ids": [
            "FraudPreventionAndDetection"
         ]
      }
   ],
   "terms_and_conditions_accepted": true,
   "infrastructure_locations": [
      "ES"
   ],
   "privacy_policy_url": "https://www.businessinc.com/application_privacy_policy"
}'

すべての操作とパラメーターの完全なリストは APIリファレンス.

その他の事業

について /catalogue エンドポイント は、国、カテゴリー、組織の種類や目的などの有用なリソースをリストアップするために使用することができます:

  • [GET] /v1/network-registry/catalogue/countries:対応国一覧
  • [GET] /v1/network-registry/catalogue/organization-types:サポートされる組織タイプの一覧
  • [GET] /v1/network-registry/catalogue/categories:対応カテゴリー一覧
  • [GET] /v1/network-registry/catalogue/network-apis:対応ネットワーク機能一覧
  • [GET] /v1/network-registry/catalogue/purposes:対応目的一覧