Sélectionner le catalogue actif

Un établissement peut avoir plusieurs catalogues rattachés, mais l’IA prend les commandes depuis un seul catalogue actif. Sélectionnez-le une fois le catalogue créé et, pour un snapshot complet, après la réussite de sa synchronisation.

PUT /v1/locations/{location_id}/active_catalog

Cette opération modifie uniquement la sélection pour l’établissement. Elle ne copie, ne modifie et ne supprime aucun catalogue.

Sélectionner un catalogue

Envoyez l’id public du catalogue limité à l’établissement, tel qu’il est retourné par l’API Catalogues. N’envoyez pas un ID interne de la base de données Chataigne.

curl https://server.chataigne.ai/v1/locations/loc_r8v4n2c6tz/active_catalog \
  -X PUT \
  -H "x-api-key: $CHATAIGNE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "catalog_id": "delivery-menu"
  }'

La requête nécessite catalog.write. La clé API doit autoriser l’établissement ciblé. Une requête réussie retourne 200 OK et renvoie l’ID public sélectionné :

{
  "object": "active_catalog",
  "location_id": "loc_r8v4n2c6tz",
  "catalog_id": "delivery-menu"
}

Vous pouvez répéter la sélection avec le même catalog_id. Pour revenir au catalogue précédent, envoyez son ID public.

Limitation à l’établissement

Les IDs de catalogue ne sont uniques qu’au sein d’un établissement. Chataigne résout le catalog_id dans l’établissement indiqué dans l’URL et conserve la relation privée correspondante en interne. Un catalogue inexistant ou non rattaché à cet établissement retourne 404 catalog_not_found. Ce comportement sécurisé par défaut empêche une clé limitée à un établissement de sélectionner le catalogue d’un autre.

Validation et erreurs

Statut	Code	Cause
`400`	`catalog_validation_error`	Le corps n’est pas un objet, ou le `catalog_id` est absent ou invalide.
`400`	`parameter_not_allowed`	Le corps contient un champ autre que `catalog_id`.
`404`	`location_not_found`	L’établissement ciblé n’existe pas.
`404`	`catalog_not_found`	L’ID public est inconnu ou le catalogue n’est pas rattaché à l’établissement.

La référence générée API Catalogues dans la barre latérale contient les schémas complets de requête et de réponse.

​Sélectionner un catalogue

​Limitation à l’établissement

​Validation et erreurs

Sélectionner un catalogue

Limitation à l’établissement

Validation et erreurs