API — Introduction

Dernière mise à jour: 08. octobre 2026

L'API configento.app vous permet de gérer vos configurateurs par programmation — lire, créer et modifier des composants, groupes, caractéristiques, valeurs, règles et listes de prix, puis publier vos modifications. Idéale pour transférer des données depuis un système PIM ou ERP.

Authentification

Chaque requête nécessite une clé API dans l'en-tête Authorization :

Authorization: Bearer VOTRE_CLE_API
Accept: application/json
Content-Type: application/json

Vous créez les clés API dans le backend V3 sous Paramètres → API : saisissez un nom, choisissez l'autorisation, définissez si besoin une date d'expiration, cliquez sur Créer. La clé n'est affichée qu'une seule fois — copiez-la immédiatement et conservez-la en lieu sûr.

Important :

Une clé appartient au service (commande de service) sélectionné lors de sa création et ne fonctionne qu'avec ses composants.
Vous pouvez créer autant de clés que vous le souhaitez — idéalement une par intégration, afin de pouvoir les révoquer individuellement.
Une clé peut avoir une date d'expiration facultative : elle fonctionne jusqu'à la fin de ce jour, puis est refusée avec 401. Vous pouvez déplacer ou supprimer la date à tout moment — une clé déjà expirée redevient ainsi valable. Sans date, une clé n'expire jamais.
Les clés se gèrent uniquement dans le backend. L'API elle-même ne permet ni de créer, ni de modifier, ni de supprimer des clés.

Autorisations

Autorisation	Permet
Lecture seule	Uniquement des requêtes `GET` — consulter les données, sans rien modifier
Lecture et écriture	En plus : créer, modifier et supprimer des brouillons — composants, groupes, caractéristiques, valeurs, règles, listes de prix, tags
+ Publier	En plus : publier et supprimer des composants — les deux agissent immédiatement sur la boutique
+ IA	En plus : utiliser l'assistant IA via l'API — consomme des jetons IA

Publier et IA ne peuvent être accordés qu'avec Lecture et écriture et sont désactivés par défaut. Un PIM peut ainsi gérer les prix et les valeurs dans le brouillon, tandis qu'une personne vérifie et publie. Vous pouvez modifier les autorisations d'une clé à tout moment dans la liste — elles s'appliquent dès la requête suivante.

Disponible pour aucune clé, quelle que soit son autorisation : gérer les clés, acheter des jetons IA, lire ou renouveler les identifiants d'intégration (plugins de boutique, extrait HTML5). Cela reste réservé au backend — une clé perdue ne peut ni s'émettre une clé de remplacement, ni générer des coûts.

URL de base

https://admin.configento.app/api/v1

Modèle de données

Composant
├── Groupes
│   └── Caractéristiques
│       └── Valeurs
└── Règles

Les composants avec un ID positif sont publiés, ceux avec un ID négatif sont des brouillons non publiés. Toute modification effectuée via l'API est d'abord enregistrée dans le brouillon — seule la publication la met en ligne dans la boutique.

Principaux endpoints

Composants

GET    /components                          # Lister tous les composants
GET    /components/{id}                     # Composant avec groupes, caractéristiques, valeurs et règles
POST   /components                          # Créer un composant vide
PUT    /components/{id}                     # Modifier les paramètres du composant
DELETE /components/{id}                     # Supprimer le composant (aussi en ligne !) — Publier
POST   /components/{id}/duplicate           # Copier le composant

Groupes et caractéristiques

POST   /components/{id}/groups                              # Créer un groupe
PUT    /components/{id}/groups/{gid}                        # Modifier un groupe
DELETE /components/{id}/groups/{gid}                        # Supprimer un groupe
POST   /components/{id}/groups/{gid}/characteristics        # Créer une caractéristique
PUT    /components/{id}/groups/{gid}/characteristics/{cid}  # Modifier une caractéristique
DELETE /components/{id}/groups/{gid}/characteristics/{cid}  # Supprimer une caractéristique

Valeurs

POST   /components/{id}/characteristics/{cid}/values         # Créer une valeur
PUT    /components/{id}/characteristics/{cid}/values         # Remplacer toutes les valeurs d'un coup
PUT    /components/{id}/characteristics/{cid}/values/{vid}   # Modifier une valeur
DELETE /components/{id}/characteristics/{cid}/values/{vid}   # Supprimer une valeur

Prix

GET    /components/{id}/characteristics/{cid}/pricelist           # Récupérer les prix dégressifs
PUT    /components/{id}/characteristics/{cid}/pricelist           # Remplacer les prix dégressifs
POST   /components/{id}/characteristics/{cid}/matrix/upload       # Téléverser une matrice de prix en CSV

Règles

GET    /components/{id}/rules          # Récupérer les règles
POST   /components/{id}/rules          # Créer une règle
PUT    /components/{id}/rules/{rid}    # Modifier une règle
DELETE /components/{id}/rules/{rid}    # Supprimer une règle

Versions et publication

GET    /components/{id}/versions                       # Versions enregistrées
POST   /components/{id}/versions/{version}/restore     # Restaurer une version comme brouillon
POST   /components/{id}/publish                        # Publier le brouillon — Publier
GET    /components/{id}/publish/status                 # Avancement de la publication

La liste complète avec tous les champs se trouve dans la référence API.

Exemple : créer une caractéristique avec des valeurs

Créer une caractéristique dans le groupe 5 du composant 123 :

POST /components/123/groups/5/characteristics
Authorization: Bearer VOTRE_CLE_API
Content-Type: application/json

{
  "alt_title": "couleur",
  "title": { "fr_FR": "Couleur", "de_DE": "Farbe" },
  "type": "select",
  "is_required": "1"
}

La réponse contient l'ID de la nouvelle caractéristique (ici 42). Définissez ensuite toutes les valeurs d'un coup :

PUT /components/123/characteristics/42/values
Authorization: Bearer VOTRE_CLE_API
Content-Type: application/json

{
  "values": [
    { "title": { "fr_FR": "Blanc" },              "value": "blanc",       "price": 0 },
    { "title": { "fr_FR": "Anthracite" },         "value": "anthracite",  "price": 15.00 },
    { "title": { "fr_FR": "Laque RAL spéciale" }, "value": "ral",         "price": 45.00 }
  ]
}

alt_title est le nom interne de la caractéristique (lettres, chiffres et _ uniquement) — c'est par lui que les formules y font référence. Les textes comme title sont des objets avec une entrée par langue.

Exemple : téléverser une matrice de prix

POST /components/123/characteristics/77/matrix/upload
Authorization: Bearer VOTRE_CLE_API
Content-Type: application/json

{
  "name": "Prix 2026",
  "csv": ";500;1000;1500\n500;89;119;149\n1000;129;169;209",
  "delimiter": ";"
}

La première ligne contient les valeurs de l'axe X, la première colonne celles de l'axe Y. Vous pouvez aussi envoyer le fichier en multipart/form-data dans le champ file. Pour en savoir plus : Matrices de prix depuis Excel/CSV.

Exemple : publier

POST /components/123/publish
Authorization: Bearer VOTRE_CLE_API

La publication s'exécute en arrière-plan. La réponse 202 Accepted contient l'adresse à interroger pour suivre l'avancement (GET /components/123/publish/status). La clé doit disposer de l'autorisation Publier.

Codes d'erreur

Statut	Signification
`401`	Clé API absente, invalide, révoquée ou expirée
`403`	La clé n'a pas ce droit — par ex. « This API key is read-only. » pour une requête d'écriture avec une clé en lecture seule, ou l'endpoint est fermé aux clés API
`404`	Le composant, la caractéristique ou la valeur n'existe pas (ou appartient à un autre service)
`409`	Une publication est déjà en cours pour ce composant
`422`	Données invalides — la réponse indique les champs concernés
`429`	Trop de requêtes en peu de temps — patientez un instant et réessayez

Référence API complète

Tous les endpoints avec leurs champs, des exemples et la possibilité de les tester dans le navigateur : admin.configento.app/docs/api — également accessible via Paramètres → API → Documentation API dans le backend V3.

Support

Pour toute question sur l'API : contactez le support via le bouton de chat du portail de service.

Prochaines étapes

← Tous les articles Essai gratuit 14 jours