The Launcher API is designed to be used to build widgets upon. This is the foundational API for all of our widgets.

🔗 Accessing the Launcher API

The base URL for the Launcher API is https://launcher.api.influence.io

🔒 Customer Digest

For some endpoints, you will need to provide a digest generated with some customer details and your API key.

The digest is a SHA256 HMAC hash. Concatenate your shop key, customer email and customer external ID as a string and generate the HMAC hash using your API Key.

You can find your API Key from the Influence.io dashboard.

Go to Settings >> __PLATFORM__ Settings >> Platform API Settings.

Where __PLATFORM__ Settings is API Settings or Shopify Settings

const shopKey = "example-com";
const apiKey = "EXAMPLE_API_KEY"
const customerEmail = "[email protected]";
const customerId = "external-123";

// Convert the email to lowercase
customerEmail = customerEmail.toLowerCase();

const hmac = createHmac("sha256", apiKey)
    .update(shopKey + customerEmail + customerId)
    .digest("hex");

$shopKey = "example-com";
$apiKey = "EXAMPLE_API_KEY"
$customerEmail = "[email protected]";
$customerId = "external-123";

// Convert the email to lowercase
$customerEmail = strtolower($customerEmail);

$hmac = hash_hmac("sha256", shopKey . customerEmail . customerId, apiKey);

<div class="influenceio-widgets-init"
  data-shop="{{ shop.permanent_domain }}"
  data-base-url="{{ shop.metafields['influenceio'].baseUrl }}"
  {% if customer %}
    data-customer-email="{{ customer.email | escape }}"
    data-customer-id="{{ customer.id | escape }}"
    data-customer-digest="{{ shop.permanent_domain | append: customer.email | append: customer.id | hmac_sha256: shop.metafields['influenceio'].secret }}"
  {% endif %}
></div>

If you are using the "Headless" widget, you can access the data-customer-digest property that is automatically generated when a customer logs into your Shopify store.