Guides
Authentication

Authentication

In order to get results from the autcomplete widget you have to setup your widget with the API Key.

1. Set the widget API Key

The API Key is a 16 numbers combination, and it's bound to your website domain.

<hvs-widget apikey="1847564823735867"> </hvs-widget>
2. Automated configuration

When you set the apikey the widget will try to validate the Api Key against our servers and return a configuration object with the following possible values:

  • states_allowed: Limit the addresses results by US states.
  • url: The URL where the widget will redirect the user when seleting an address.
  • domain: The domain allowed to use the API Key.
{
  "states_allowed": "AL,AK,AZ,AR,CA,CO,CT,DC,DE,FL,GA",
  "url": "http://findbuyers.com",
  "domain": "findbuyers.getbuyside.com"
}

These settings will configure automatically if you don't provide any manual configuration on the widget declaration.

⚠️

Any manual configuration on the <hvs-widget> component will override the API Key configuration