API — Einstieg & Übersicht

Die configento.app API ermöglicht es, Konfiguratordaten programmatisch zu verwalten — Merkmale, Optionen, Preise und Regeln anlegen, lesen und aktualisieren. Ideal wenn du große Datenmengen aus einem PIM- oder ERP-System übertragen möchtest.

Authentifizierung

Alle API-Anfragen werden über einen API-Token authentifiziert. API-Tokens erstellst du im V3-Backend unter Einstellungen → API. Den Sicherheitsschlüssel deines Dienstes findest du im Service-Portal unter Dienste.

Authorization: Bearer DEIN_API_TOKEN
Content-Type: application/json

Basis-URL

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

Ressourcen

Komponenten

GET    /components              # Alle Komponenten auflisten
GET    /components/{id}         # Eine Komponente abrufen
POST   /components              # Neue Komponente anlegen
PUT    /components/{id}         # Komponente aktualisieren
DELETE /components/{id}         # Komponente löschen

Merkmale

GET    /components/{id}/features           # Alle Merkmale einer Komponente
POST   /components/{id}/features           # Merkmal anlegen
PUT    /components/{id}/features/{fid}     # Merkmal aktualisieren
DELETE /components/{id}/features/{fid}     # Merkmal löschen

Optionen

GET    /features/{id}/options              # Alle Optionen eines Merkmals
POST   /features/{id}/options              # Option anlegen
PUT    /features/{id}/options/{oid}        # Option aktualisieren
DELETE /features/{id}/options/{oid}        # Option löschen

Preislisten

GET    /components/{id}/pricelists         # Preislisten abrufen
POST   /components/{id}/pricelists         # Preisliste hochladen (CSV)
DELETE /components/{id}/pricelists/{plid}  # Preisliste löschen

Beispiel: Merkmal anlegen

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

{
  "name": "Farbe",
  "type": "select",
  "required": true,
  "sort_order": 1,
  "options": [
    { "name": "Weiß", "surcharge": 0 },
    { "name": "Anthrazit", "surcharge": 15.00 },
    { "name": "RAL Sonderlack", "surcharge": 45.00 }
  ]
}

Beispiel: Preisliste hochladen

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

file: preisliste.csv
row_feature_id: 456
col_feature_id: 457

Rate Limiting

Die API erlaubt 1.000 Anfragen pro Minute. Bei Überschreitung wird der Status 429 Too Many Requests zurückgegeben.

Vollständige API-Dokumentation

Die vollständige API-Referenz mit allen Endpunkten, Parametern und Fehlercodes findest du unter Einstellungen → API → API-Dokumentation im V3-Backend.

Support

Bei Fragen zur API: Support über den Chat-Button im Service-Portal.

Nächste Schritte

• Erste Komponente anlegen
• Merkmale & Optionen anlegen
• Preismatrizen aus Excel/CSV