Customizing the Data.com integration

Kentico EMS required

Features described on this page require the Kentico EMS license.

The Data.com integration stops working as of 1st September 2016, because Data.com terminates third party access to their API. We are sorry for any inconvenience caused.

If you wish to customize any aspect of the Data.com integration, you need to request your own API access token from Data.com.

Important: Modifying or extending the default functionality without using your own Data.com token is a violation of the licensing terms.

Using a custom Data.com API token

Follow the steps below if you need to work with a custom Data.com access token in your API:

  1. Open your web project in Visual Studio.

  2. Create a new class:

    • In the project’s App_Code folder (or CMSApp_AppCode -> Old_App_Code if the project is installed as a web application)
      OR
    • As part of a custom assembly (Class library)
  3. Add a reference to the CMS.DataCom namespace:

    
    
    
      using CMS.DataCom;
    
    
     
  4. Make the class implement the ITokenProvider interface.

  5. Add the GetToken() method and return your Data.com token as a string:

    
    
    
     public class CustomDataComTokenProvider : ITokenProvider
     {
         /// <summary>
         /// Gets the token used for Data.com communication.
         /// </summary>
         /// <returns>Token</returns>
         public string GetToken()
         {
             return "Your Data.Com API Token";
         }
     }
    
    
     

Whenever you call the DataComHelper.CreateClient method in your custom code, add an instance of your ITokenProvider class as a parameter:




using CMS.DataCom;

...

DataComClient client = DataComHelper.CreateClient(new CustomDataComTokenProvider());