Integration Guide
Technical Documentation for Licensees
Version 1.0 • 2026
1. Quick Start (5 Minutes)
- Install the Haptic Zones SDK via npm or CDN.
- Locate your License Key in the Dashboard.
- Initialize the library with your key.
- Verify connection in your browser console.
import { HapticZones } from '@hapticzones/sdk';
const hz = new HapticZones({
licenseKey: 'HAPTICZONES-2026-YOUR-KEY-HERE',
environment: 'production'
});
await hz.init();
2. Integration Options
Option A: Direct (Client-Side)
Best for web apps, SPAs, and simple sites. Validate directly in the browser.
npm install @hapticzones/web
Option B: API (Server-Side)
Best for secure environments, mobile apps backend, and enterprise systems.
POST https://api.hapticzones.com/v1/verify
3. System Requirements
- Node.js v14+ or Modern Browser (Chrome 90+, Firefox 88+, Safari 14+)
- TLS 1.2+ for all API connections
- Valid License Key (Active status)
- Network access to
api.hapticzones.comon port 443
4. Full Code Examples
React / Next.js
// components/HapticProvider.js
import { useEffect } from 'react';
import { HapticZones } from '@hapticzones/react';
export function HapticProvider({ children }) {
useEffect(() => {
HapticZones.configure({ key: process.env.NEXT_PUBLIC_HZ_KEY });
}, []);
return <div className="hz-root">{children}</div>;
}
Python / Django / Flask
import requests
def verify_license(key):
response = requests.post(
"https://api.hapticzones.com/v1/verify",
json={"license_key": key},
headers={"Authorization": f"Bearer {API_SECRET}"}
)
return response.json().get('valid', False)
5. Troubleshooting
Error 401
Invalid License Key
Check that you copied the key correctly from the dashboard. Keys are case-sensitive.
Error 403
Domain Restriction
Your license is restricted to specific domains. Update your allowed domains in the dashboard.