Démarrer avec l'API Conciar

Conciar propose deux API. Utilisez-les pour créer votre propre app client, le backend d'un site web ou une intégration sur la base de votre compte Conciar.

API	À quoi elle sert	Clé	URL de base
API Connect	Établissements, carte du restaurant et commandes à emporter, connexion et fidélité des clients, catalogue de la boutique en ligne, panier, paiement de la commande et abonnements.	Oui	https://api.conciar.com/connect/v1
API publique de réservation	Réservations de table : disponibilités, réservation (avec acompte ou garantie par carte), propre réservation du client, événements avec billetterie et cartes cadeaux.	Non	https://api.conciar.com/public/v1

L'API publique de réservation ne nécessite aucune clé. Vous désignez un restaurant par son guid. Si vous voulez seulement des réservations sur un site web, vous n'avez rien à développer : intégrez le widget de réservation.

1. Créer une clé API

1. Connectez-vous à my.conciar.com en tant qu'admin ou manager.
2. Ouvrez Management → API Keys et cliquez sur New API Key.
3. Saisissez un Key Name, par exemple « App client », et cliquez sur Create Key.
4. Copiez immédiatement les deux parties de la clé : la clé publique (pk_…) et la clé secrète (cnct_…). Elles ne sont affichées qu'une seule fois.

La différence entre les deux parties, et comment les protéger, est expliquée dans Clés API et authentification.

2. Trouver le jeton de votre canal de vente

Chaque établissement ou boutique par lequel vous vendez est un canal de vente. Les appels à /store/… et /app/init nécessitent le jeton du canal (cnct_ch_…) dans l'en-tête X-Sales-Channel. Le canal détermine la carte ou le catalogue, les prix, la devise, la langue et les moyens de paiement.

Vous trouvez le jeton à deux endroits :

• sur my.conciar.com sous Settings → Sales channels, en tant que Channel token ;
• dans la réponse de GET /locations, en tant que sales_channel_token.

3. Faire votre première requête

Listez vos établissements avec la clé publique :

curl "https://api.conciar.com/connect/v1/locations" \
  -H "Accept: application/json" \
  -H "X-Api-Key: pk_your_publishable_key"

Réponse (abrégée) :

{
  "data": {
    "timezone": "Europe/Amsterdam",
    "locations": [
      {
        "sales_channel_token": "cnct_ch_your_channel_token",
        "name": "Bistro Example",
        "is_test": false,
        "address": "Example Street 1, 1000 AA Example City",
        "is_open_now": true
      }
    ]
  }
}

GET /locations liste vos canaux de vente actifs. Les canaux des plateformes de livraison, comme Uber Eats, ne figurent pas dans la liste.

En-têtes de requête

En-tête	Quand	Valeur
X-Api-Key	Chaque appel Connect	Votre clé publique (pk_…) ou secrète (cnct_…).
X-Sales-Channel	Chaque appel /store/… et /app/init	Le jeton du canal (cnct_ch_…).
Accept-Language	Facultatif	Par exemple nl ou zh-TW. Par défaut, la langue du canal.
X-Currency	Facultatif	Par défaut, la devise du canal. Une valeur inconnue est ignorée.
Authorization	Appels pour un client connecté	Bearer <access_token> obtenu via /auth/otp/verify.
Idempotency-Key	Facultatif, lors de la création d'une commande restaurant	1 à 64 caractères. Un nouvel essai avec la même clé renvoie la première commande.
X-Order-Token	Un client invité qui consulte, paie ou annule une commande restaurant	Le order_token reçu lors de la création de la commande.

Clients connectés

Les clients se connectent avec un code à 6 chiffres envoyé par e-mail :

1. POST /auth/otp/request envoie le code.
2. POST /auth/otp/verify le vérifie et renvoie un access_token. Le jeton est valable 6 mois.

Envoyez le jeton sous la forme Authorization: Bearer … en plus de la clé API. Les endpoints /store/customer/… l'exigent. Sur les commandes restaurant, il est facultatif : avec lui, la commande appartient au client et lui rapporte des tampons et des points de fidélité.

Sans code : le widget de réservation

Pour prendre des réservations de table sur votre site, collez ce code là où le formulaire de réservation doit apparaître. Remplacez le guid par celui de votre restaurant ; vous trouverez l'extrait complet sur my.conciar.com sous Settings → Restaurant.

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

data-lang accepte un code de langue comme en ou nl, ou auto pour la langue du navigateur du visiteur.

Étapes suivantes

• Clés API et authentification : types de clés, erreurs et limites de requêtes.
• Référence de l'API : chaque endpoint, avec des exemples.
• Exemples de code : une commande à emporter, la connexion d'un client et une réservation de table, étape par étape.