DeveloperAPI-DossierAkte · API-V1Zugang · auf AnfrageREC
Programmatischer Zugriff · REST-API für Partner

Die
CIA Tuning API

Binde unseren ECU-Fileservice direkt in deine Systeme ein. Über unsere REST-API lädst du Steuergerätedateien automatisiert hoch, wählst Solutions oder Tuning-Stufen, verfolgst den Status und holst dir die optimierte Datei samt Original-Backup zurück — vollständig programmatisch. So baust du auf unserer Infrastruktur deine eigenen Automatisierungen und Teilautomationen auf: White-Label-Portale, Werkstatt-Anbindungen oder komplett unbeaufsichtigte Workflows.

  • RESTJSON / HTTPS
  • WebhooksStatus-Callbacks
  • API-KeyScoped & widerrufbar
  • 15–60 MinBearbeitung

Was du damit bauen kannst

Die API ist die Basis für eigene automatisierte Systeme und Teilautomationen — du bestimmst, wie viel Mensch noch im Prozess steckt.

White-Label-Portale

Biete deinen Kunden ein eigenes Tuning-Portal unter deiner Marke an — der Upload, die Bearbeitung und der Download laufen im Hintergrund über unsere API.

Werkstatt-Anbindung

Integriere den Fileservice direkt in deine Werkstatt- oder DMS-Software. Auftrag anlegen, Datei senden, Ergebnis automatisch im System verbuchen.

Voll- & Teilautomation

Von „ein Klick spart manuelle Schritte“ bis zum komplett unbeaufsichtigten Workflow: Du entscheidest, welche Schritte automatisch laufen und wo ein Mensch freigibt.

Batch & Flotten

Verarbeite viele Fahrzeuge programmatisch in Reihe — ideal für Flotten, Händlerketten und Vielnutzer mit gleichbleibenden Aufträgen.

So funktioniert der Datenfluss

  1. Authentifizieren

    Jeder Request trägt deinen scoped API-Key im Header. Keys sind pro Umgebung (Sandbox/Live) getrennt und jederzeit widerrufbar.

  2. Auftrag anlegen & Datei senden

    Du erstellst einen Auftrag, lädst die ausgelesene ECU-Originaldatei hoch und wählst die gewünschte Solution oder Tuning-Stufe.

  3. Status verfolgen

    Per Polling oder — empfohlen — per Webhook erhältst du den Bearbeitungsstatus in Echtzeit, ohne ständig nachfragen zu müssen.

  4. Ergebnis abholen

    Sobald die Datei fertig ist, lädst du die optimierte Version inklusive unverändertem Original-Backup automatisiert herunter.

In Minuten integriert

Authentifizierung per API-Key im Header, ein Auftrag in einem Request. Beispiel: Datei einreichen und Solution buchen.

BASE URL · https://api.cia-tuning.de/v1
# 1) Auftrag anlegen und ECU-Datei einreichen
curl -X POST https://api.cia-tuning.de/v1/orders \
  -H "Authorization: Bearer $CIA_API_KEY" \
  -F "solution=stage-1" \
  -F "vehicle=VW Golf 7 2.0 TDI" \
  -F "file=@golf7_read.bin"

# Antwort: { "id": "ord_8F2A...", "status": "queued" }

# 2) Status abfragen (oder Webhook nutzen)
curl https://api.cia-tuning.de/v1/orders/ord_8F2A \
  -H "Authorization: Bearer $CIA_API_KEY"

# 3) Fertige Datei herunterladen, sobald status = "ready"
curl -L https://api.cia-tuning.de/v1/orders/ord_8F2A/download \
  -H "Authorization: Bearer $CIA_API_KEY" -o golf7_stage1.bin

Die wichtigsten Endpunkte

Vollständige Referenz und Felder erhältst du mit deinem Zugang.

POST/v1/ordersAuftrag anlegen, ECU-Datei hochladen und Solution/Stufe wählen.
GET/v1/orders/{id}Status und Details eines Auftrags abfragen.
GET/v1/orders/{id}/downloadOptimierte Datei und Original-Backup herunterladen.
GET/v1/ordersAufträge auflisten, filtern und paginieren.
POST/v1/webhooksCallback-URL registrieren, um Status-Events in Echtzeit zu erhalten.
GET/v1/solutionsVerfügbare Solutions, Tuning-Stufen und Konditionen abfragen.
GET/v1/accountKonto, Rang und aktuelle B2B-Konditionen auslesen.

Sicherheit & Zuverlässigkeit

Verschlüsselte Übertragung

Sämtliche Requests laufen ausschließlich über HTTPS/TLS. Dateien werden verschlüsselt übertragen und nur zur Auftragsbearbeitung genutzt.

Scoped & widerrufbare Keys

API-Keys sind an deinen Account gebunden, pro Umgebung getrennt (Sandbox/Live) und lassen sich jederzeit rotieren oder sperren.

Signierte Webhooks

Status-Callbacks sind signiert, sodass du die Echtheit jedes Events serverseitig verifizieren kannst.

Idempotenz & Rate-Limits

Idempotency-Keys verhindern doppelte Aufträge; klare Rate-Limits sorgen für stabile, planbare Integrationen.

Original-Backup garantiert

Jede Antwort enthält neben der optimierten Datei auch das unveränderte Original — Werkszustand jederzeit wiederherstellbar.

Sandbox-Umgebung

Teste deine Integration risikofrei gegen die Sandbox, bevor du auf Live-Aufträge umstellst.

Zugang auf Anfrage

API-Schlüssel anfordern

Der API-Zugang ist Teil unserer B2B-Partnerschaft und wird auf Anfrage freigeschaltet. Schreib uns kurz, was du bauen möchtest und welches Volumen du erwartest — nach einem kostenlosen Erstgespräch erhältst du deinen scoped API-Key, Zugang zu Sandbox & Doku und wirst ins Agenten-Team aufgenommen.

Noch kein Partner? B2B-Partner werden oder alle Solutions ansehen.

Häufige Fragen zur API

Wie bekomme ich Zugang zur API?
Der API-Zugang ist Teil unserer B2B-Partnerschaft und wird auf Anfrage freigeschaltet. Nach einem kostenlosen Erstgespräch erhältst du deinen API-Key sowie Zugang zu Sandbox und Dokumentation.
Was kostet die Nutzung der API?
Die API selbst hat keine Grundgebühr. Du zahlst pro bearbeiteter Datei zu deinen B2B-Konditionen — mit steigendem Volumen verbessern sich die Konditionen über das Rangsystem (bis 20 % Rabatt).
Gibt es eine Sandbox zum Testen?
Ja. Du erhältst getrennte Keys für Sandbox und Live. In der Sandbox kannst du den kompletten Ablauf inklusive Webhooks risikofrei durchspielen, bevor echte Aufträge entstehen.
Wie erfahre ich, wenn eine Datei fertig ist?
Empfohlen sind Webhooks: Du registrierst eine Callback-URL und erhältst signierte Status-Events in Echtzeit. Alternativ kannst du den Status per Polling abfragen.
Welche Formate und Tools werden unterstützt?
Du lädst die ausgelesene Originaldatei deines Slave-Tools (z. B. KESS3, Autotuner, CMD) hoch — wie im manuellen Portal. Die API erkennt das Format und liefert die passende optimierte Datei zurück.
Kann ich die API unter eigener Marke (White-Label) anbieten?
Ja. Du kannst auf Basis der API ein eigenes Portal oder eine eigene App unter deiner Marke betreiben. Die Bearbeitung läuft im Hintergrund über unsere Systeme.
Gelten für API-Solutions dieselben rechtlichen Hinweise?
Ja. Software-Solutions wie DPF-, AGR-, SCR- oder Lambda-Off sind ausschließlich für den Motorsport auf abgesperrtem Gelände bestimmt. Die Verantwortung für den gesetzeskonformen Einsatz liegt beim Partner bzw. Endkunden.