Entwickler

SDKs & Bibliotheken

Fertiger Code, um schneller auf Conciar aufzubauen: ein Starter für Ihren eigenen Shop und das Buchungswidget.

Der technische Inhalt unten ist auf Englisch, wie bei Entwicklerdokumentation üblich.

npmVue 3 · Vite · Tailwind · PiniaMIT

@conciar/create-vue-shop

Scaffold a headless storefront for Vue, wired to the Conciar Connect API and ready to rebrand. The CLI asks for a project name, your API base URL, your Connect API key and your sales-channel key, writes .env.local and prints the next steps. Requires Node 18 or newer.

Terminal
npm create @conciar/vue-shop@latest my-shop
cd my-shop
npm install
npm run dev

Leave VITE_CONCIAR_API_URL empty to run in mock mode with built-in sample data before you connect your keys. View on npm

What you get

  • Catalogue and product pages

    Listing with search, filters and pagination; product detail with specs, tax breakdown and a compare tray.

  • Cart and checkout

    Cart drawer, coupons, automatic promotions, PostNL pickup points and delivery time slots, and a checkout the server validates.

  • Customer accounts

    Sign-in with a one-time code, order history and detail, and subscription management.

  • Four languages

    English, Dutch, French and German through vue-i18n.

  • Conciar core

    A typed API client, Pinia stores (cart, store config, countries, customer) and composables, kept apart from the UI.

  • Easy to rebrand

    One primary colour variable, fonts in one stylesheet, and all copy in the locale files.

Configuration

VariablePurpose
CONCIAR_API_URLAPI base URL, used by the dev proxy and the production server (server only).
CONCIAR_API_KEYYour Connect API key (server only, never bundled).
CONCIAR_SALES_CHANNEL_KEYYour sales-channel key (server only).
VITE_SHOP_NAMEShop name shown in the logo, footer and loading screen.
VITE_CONCIAR_API_URLAny value switches mock mode off and enables real API calls.
VITE_APP_URLPublic URL of the shop.
PORTPort of the production server (optional, default 3000).

Deploy

The secret API key is never bundled into the browser. In development the Vite proxy adds it; in production a small, dependency-free Node server (server.mjs) serves the built app and proxies /api with the key added on the server. Run it behind your own TLS reverse proxy.

Terminal
npm run build   # static assets in ./dist
npm start       # serves ./dist and proxies /api with your key added server-side
Script tag

Booking widget

Put table reservations or a lead form on any website with two lines of HTML. Use your organization GUID from my.conciar (Settings → Restaurant shows the ready-made snippet). Set data-widget-type to professional-lead-form and add data-lead-form-id for a lead form.

HTML
<div class="conciar-widget"
     data-widget-type="restaurant-reservation"
     data-guid="YOUR_ORGANIZATION_GUID"
     data-lang="auto"></div>
<script src="https://widget.conciar.com/conciar-widget.iife.js" defer></script>

Other languages and frameworks

There is no official client for other languages yet. The Connect API is plain JSON over HTTPS, so any HTTP client works: start with the guide, look up endpoints in the reference, and copy a complete flow from the examples.