API del Registro de red

El proceso de solicitud de autorización detallado en el Registro de red La guía también se puede gestionar mediante programación utilizando el API del 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 de empresa

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 denominado «Mi perfil de empresa», en la que se solicita acceso a operadores de España y Alemania. El cuerpo de la solicitud contiene la misma información que se solicita en el panel de control del Registro de Redes (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ía una solicitud PUT utilizando /change-request y el ID de tu perfil de empresa:

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

En el siguiente documento se puede consultar una lista completa de todas las operaciones y parámetros: Referencia API.

Gestión de los perfiles de las Applications

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

En el siguiente documento se puede consultar una lista completa de todas las operaciones y parámetros: Referencia API.

Otras operaciones

El /catalogue punto final se puede utilizar para enumerar recursos útiles, como países, categorías, tipos de organizaciones o finalidades:

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