SDK et bibliothèques
Du code prêt à l'emploi pour construire plus vite sur Conciar : un starter pour votre propre boutique et le widget de réservation.
Le contenu technique ci-dessous est en anglais, comme d'usage pour la documentation développeur.
@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.
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
| Variable | Purpose |
|---|---|
| CONCIAR_API_URL | API base URL, used by the dev proxy and the production server (server only). |
| CONCIAR_API_KEY | Your Connect API key (server only, never bundled). |
| CONCIAR_SALES_CHANNEL_KEY | Your sales-channel key (server only). |
| VITE_SHOP_NAME | Shop name shown in the logo, footer and loading screen. |
| VITE_CONCIAR_API_URL | Any value switches mock mode off and enables real API calls. |
| VITE_APP_URL | Public URL of the shop. |
| PORT | Port 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.
npm run build # static assets in ./dist
npm start # serves ./dist and proxies /api with your key added server-sideBooking 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.
<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.