Docs  /  API  /  API — Introduction

API — Introduction

Dernière mise à jour: 01. janvier 2026

L'API configento.app permet de gérer les données du configurateur par programmation — créer, lire et mettre à jour des caractéristiques, des options, des prix et des règles. Idéale si vous souhaitez transférer de grands volumes de données depuis un système PIM ou ERP.

Authentification

Toutes les requêtes API sont authentifiées par un token API. Vous créez les tokens API dans le backend V3 sous Paramètres → API. La clé de sécurité de votre service se trouve dans le portail de service sous Services.

Authorization: Bearer VOTRE_TOKEN_API
Content-Type: application/json

URL de base

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

Ressources

Composants

GET    /components              # Lister tous les composants
GET    /components/{id}         # Récupérer un composant
POST   /components              # Créer un composant
PUT    /components/{id}         # Mettre à jour un composant
DELETE /components/{id}         # Supprimer un composant

Caractéristiques

GET    /components/{id}/features           # Toutes les caractéristiques d'un composant
POST   /components/{id}/features           # Créer une caractéristique
PUT    /components/{id}/features/{fid}     # Mettre à jour une caractéristique
DELETE /components/{id}/features/{fid}     # Supprimer une caractéristique

Options

GET    /features/{id}/options              # Toutes les options d'une caractéristique
POST   /features/{id}/options              # Créer une option
PUT    /features/{id}/options/{oid}        # Mettre à jour une option
DELETE /features/{id}/options/{oid}        # Supprimer une option

Listes de prix

GET    /components/{id}/pricelists         # Récupérer les listes de prix
POST   /components/{id}/pricelists         # Téléverser une liste de prix (CSV)
DELETE /components/{id}/pricelists/{plid}  # Supprimer une liste de prix

Exemple : créer une caractéristique

POST /components/123/features
Authorization: Bearer VOTRE_TOKEN_API
Content-Type: application/json

{
  "name": "Couleur",
  "type": "select",
  "required": true,
  "sort_order": 1,
  "options": [
    { "name": "Blanc", "surcharge": 0 },
    { "name": "Anthracite", "surcharge": 15.00 },
    { "name": "Laque RAL spéciale", "surcharge": 45.00 }
  ]
}

Exemple : téléverser une liste de prix

POST /components/123/pricelists
Authorization: Bearer VOTRE_TOKEN_API
Content-Type: multipart/form-data

file: liste-de-prix.csv
row_feature_id: 456
col_feature_id: 457

Limitation de débit

L'API autorise 1 000 requêtes par minute. En cas de dépassement, le statut 429 Too Many Requests est renvoyé.

Documentation API complète

La référence API complète, avec tous les endpoints, paramètres et codes d'erreur, se trouve sous 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