Créer et modifier des établissements

Utilisez ce guide pour ajouter un restaurant à une organisation commerciale existante ou modifier le profil d’un établissement. La découverte des ressources est expliquée dans Trouver vos ressources.

Créer un établissement

Appelez POST /v1/organizations/{organization_id}/locations avec une clé limitée à une organisation commerciale. La clé doit posséder location.create et l’organisation doit se trouver dans son périmètre. Le nouvel établissement nécessite name, currency, country, timezone et une address complète. default_language, contact_information et image_url sont facultatifs. Lorsqu’il est fourni, image_url doit désigner une image JPG, PNG ou WebP accessible publiquement et ne dépassant pas 5 Mo ; Chataigne l’importe dans son stockage géré comme photo de profil de l’établissement.

curl https://server.chataigne.ai/v1/organizations/busorg_k3m9x2p7qw/locations \
  -X POST \
  -H "x-api-key: $CHATAIGNE_API_KEY" \
  -H "Idempotency-Key: 2d0876fa-dab8-43a3-b2f8-dd303e7633f5" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Maison Exemple — République",
    "currency": "EUR",
    "country": "FR",
    "timezone": "Europe/Paris",
    "default_language": "fr",
    "contact_information": "+33 1 84 80 20 20",
    "image_url": "https://images.example.com/maison-exemple-logo.png",
    "address": {
      "line1": "12 place de la République",
      "line2": null,
      "postal_code": "75011",
      "city": "Paris",
      "country": "FR",
      "latitude": 48.8674,
      "longitude": 2.363
    }
  }'

Idempotency-Key est requis pour cette création. Réutilisez la même valeur uniquement lorsque vous retentez exactement le même corps de requête. La réponse est la ressource location créée. Enregistrez son id pour les appels de paramètres et de données analytiques.

Modifier le profil d’un établissement

Appelez PATCH /v1/locations/{location_id} avec la permission location.update. Envoyez uniquement les champs à modifier :

curl https://server.chataigne.ai/v1/locations/loc_r8v4n2c6tz \
  -X PATCH \
  -H "x-api-key: $CHATAIGNE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Maison Exemple — République & Oberkampf",
    "contact_information": "+33 1 84 80 20 21",
    "image_url": "https://images.example.com/maison-exemple-nouveau-logo.png",
    "address": {
      "line2": "Entrée côté cour"
    }
  }'

PATCH effectue une mise à jour partielle :

Les champs de premier niveau omis conservent leur valeur actuelle, y compris la photo de profil.
Un image_url fourni est téléchargé, validé, stocké par Chataigne et remplace la photo de profil. Il doit s’agir d’une URL non vide — envoyer image_url: null (ou "") est rejeté avec 400 INVALID_IMAGE_URL ; l’API ne permet pas de supprimer une photo existante, omettez donc le champ pour conserver l’actuelle.
Les champs omis dans address conservent également leur valeur actuelle.
La valeur explicite null efface un champ d’adresse nullable tel que line2.

La devise, le pays et le fuseau horaire sont définis à la création et ne sont pas modifiés par cet endpoint.

Champs du profil

Champ	À la création	À la modification	Remarques
`name`	Requis	Facultatif	Nom du restaurant affiché aux clients.
`image_url`	Facultatif	Facultatif	URL publique JPG, PNG ou WebP (5 Mo max). La réponse renvoie l’URL gérée par Chataigne.
`currency`	Requis	—	Code de devise ISO pris en charge par Chataigne.
`country`	Requis	—	Code pays ISO pris en charge par Chataigne.
`timezone`	Requis	—	Fuseau horaire IANA tel que `Europe/Paris`.
`default_language`	Facultatif	Facultatif	Langue par défaut des conversations clients.
`contact_information`	Facultatif	Facultatif	Coordonnées affichées pour le restaurant.
`address`	Objet complet requis	Objet partiel facultatif	Rue, code postal, ville, pays, latitude et longitude.

Configurer l’établissement

Continuez avec les commandes, les horaires, la livraison, l’acceptation et les paramètres d’IA.

​Créer un établissement

​Modifier le profil d’un établissement

​Champs du profil

Configurer l’établissement

Créer un établissement

Modifier le profil d’un établissement

Champs du profil