API de registro de red

El proceso de solicitud de autorización detallado en el Registro de red también puede gestionarse mediante programación con la función API de registro de red. Esto permite automatizar el proceso de aprobación.

Referencia API

La especificación OpenAPI para la API de Registro de Red está disponible aquí.

Autenticación

La autenticación se basa en su Clave API y Secreto APIque se encuentra en panel de control para desarrolladores.

Gestión de perfiles empresariales

Puede crear, recuperar y eliminar perfiles de empresa mediante la función /business-profile punto final.

El siguiente ejemplo es una solicitud

POST

que crea un nuevo perfil de empresa llamado "Mi perfil de empresa", solicitando acceso a operadores en España y Alemania. El cuerpo de la llamada contiene la misma información solicitada por el cuadro de mandos del Registro de la Red (función, país, número de identificación fiscal, etc.):

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"
   }
}'

Para modificar un perfil de empresa, envíe una solicitud

PUT

utilizando /change-request y el ID de su perfil empresarial:

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"
   }
}'

Encontrará una lista completa de todas las operaciones y parámetros en la sección Referencia API.

Gestión de los perfiles de las Applications

En /application-profiles puede utilizarse para realizar todas las operaciones relacionadas con los perfiles de aplicación. Este ejemplo envía una solicitud

POST

para crear un nuevo perfil de aplicación:

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"
}'

Encontrará una lista completa de todas las operaciones y parámetros en la sección Referencia API.

Otras operaciones

En /catalogue punto final puede utilizarse para enumerar recursos útiles como países, categorías tipos de organización o propósitos:

GET
/v1/network-registry/catalogue/countries: Lista de países admitidos
GET
/v1/network-registry/catalogue/organization-types: Lista de tipos de organización admitidos
GET
/v1/network-registry/catalogue/categories: Lista de categorías admitidas
GET
/v1/network-registry/catalogue/network-apis: Lista de funciones de red compatibles
GET
/v1/network-registry/catalogue/purposes: Lista de fines admitidos