Getting started with the Comnoira integration

Every Liftira integration is made of three pieces: your website, your server, and Comnoira. Your website never hands your license key to Comnoira directly — your server exchanges it for a short-lived code first, and your website completes that exchange itself before the viewer can load. See Exchanging a session token for exactly how that works.

Before you write any code

1. Create a Comnoira account and a shop. This is where your license key and embed codes live.
2. Generate your first embed code. It works immediately — with no product attached yet, it loads a small placeholder demo, so you can wire up the integration on your site before your real 3D model exists.
3. Send us your product. Once the embed is live on a page, send your product details to your Liftira contact — we build the 3D model and publish it to that same embed code, and the placeholder demo is swapped for your real product automatically.

What you'll need

• A Comnoira license key, scoped to your shop
• A backend endpoint capable of making a server-to-server request (the license key must never reach the browser)
• One <script> tag and one <div> on the page where the configurator should appear

The two-hop flow

1. Buyer loads your page. Your server requests a short-lived exchange code from Comnoira using your license key.
2. Your server hands that code to the browser — never the license key itself.
3. The embed script exchanges that code for a real session token directly with Comnoira, which checks the request is really coming from your registered domain, then mounts the 3D configurator into your placeholder <div>.

Once you've got a token flowing end to end, the next guide covers exactly what that two-step exchange looks like, request by request.