> ## Documentation Index
> Fetch the complete documentation index at: https://docs.steerai.autos/llms.txt
> Use this file to discover all available pages before exploring further.

# API-Integrationsübersicht

> Flexible RESTful APIs für individuelle Automotive-Inspektions- und Preisfindungslösungen

## Warum API-Integration?

Ideal für Entwickler und Unternehmen, die maximale Flexibilität und individuelle Integrationen benötigen. In 48 Stunden startklar – ohne Einrichtungsgebühren.

<CardGroup cols={2}>
  <Card title="Hauptvorteile" icon="check-circle">
    • **Keine Einrichtungsgebühr** – Sofort loslegen
    • **Bereitstellung in 48 Stunden** – Schnellste API-Integration
    • **RESTful APIs** – Standardisierte, verlässliche Endpunkte
    • **Maximale Flexibilität** – Bauen Sie genau, was Sie brauchen
    • **Skalierbare Preise** – Zahlen Sie nur, was Sie nutzen
  </Card>

  <Card title="Ideal für" icon="star">
    • Entwicklungsteams mit API-Erfahrung
    • Individuelle Anwendungs-Integrationen
    • Inspektionsverarbeitung mit hohem Volumen
    • Einzigartige Workflow-Anforderungen
    • Erweiterung bestehender Anwendungen
  </Card>
</CardGroup>

## Zentrale API-Funktionen

### Fahrzeuginspektions-APIs

* **Mechanische Inspektion:** KI-gestützte Diagnoseanalyse
* **Visuelle Inspektion:** 360°-Schadenerkennung und Bewertung
* **Bildverarbeitung:** Fortgeschrittene Computer Vision zur Schadenserkennung
* **Inspektionsberichte:** Umfassende PDF- und JSON-Berichte

### Preis- & Bewertungs-APIs

* **Marktbewertung:** Echtzeit-Analyse von Marktpreisen
* **Schadensbewertung:** Berechnung des Einflusses auf den Fahrzeugwert
* **Reparaturschätzung:** Präzise Prognosen der Reparaturkosten
* **Regionale Preise:** Standortbasierte Preis-Anpassungen

### Business-Integrations-APIs

* **Interessenten-Management:** CRM-Integrationsfunktionen
* **Bestands-Sync:** Echtzeit-Bestandsmanagement
* **Vertragserstellung:** Automatisierte Dokumentenerstellung
* **Marketing-Integration:** Multi-Plattform-Marketing-Tools

## Schnellstart

### 1. API-Keys erhalten

```bash theme={null}
# Registrieren und API-Keys erhalten
curl -X POST "https://api.steerai.autos/v1/auth/register" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "your-email@company.com",
    "company": "Your Company Name"
  }'
```

### 2. Ersten API-Call ausführen

```bash theme={null}
# Authentifizierung testen
curl -X GET "https://api.steerai.autos/v1/auth/test" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### 3. Erste Inspektion erstellen

```bash theme={null}
# Fahrzeugbilder zur Inspektion senden
curl -X POST "https://api.steerai.autos/v1/inspections" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "vehicle": {
      "vin": "1HGBH41JXMN109186",
      "year": 2021,
      "make": "Honda",
      "model": "Civic"
    },
    "images": [
      "https://your-storage.com/image1.jpg",
      "https://your-storage.com/image2.jpg"
    ]
  }'
```

## API-Architektur

### Basis-URLs

* **Produktion:** `https://api.steerai.autos/v1`
* **Sandbox:** `https://api-sandbox.steerai.autos/v1`

### Authentifizierung

Alle API-Anfragen benötigen Authentifizierung per Bearer-Token im Authorization-Header.

### Response-Format

Alle Endpunkte liefern JSON mit konsistenter Struktur:

```json theme={null}
{
  "status": "success|error",
  "data": { ... },
  "meta": {
    "request_id": "req_1234567890",
    "timestamp": "2024-01-15T10:30:00Z",
    "processing_time": 1.23
  }
}
```

## Rate Limits

| Plan             | Anfragen/Stunde | Parallel    | Burst-Limit |
| ---------------- | --------------- | ----------- | ----------- |
| **Free**         | 1.000           | 5           | 50          |
| **Starter**      | 10.000          | 20          | 200         |
| **Professional** | 100.000         | 100         | 1.000       |
| **Enterprise**   | Unbegrenzt      | Individuell | Individuell |

### Rate-Limit-Header

```http theme={null}
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1640995200
X-Retry-After: 60
```

## SDK-Unterstützung

<CardGroup cols={2}>
  <Card title="Python SDK" icon="python" href="/de/sdks/python">
    ```python theme={null}
    pip install steer-ai
    ```

    Voll ausgestattetes Python SDK mit Async-Support
  </Card>

  <Card title="JavaScript SDK" icon="js" href="/de/sdks/javascript">
    ```bash theme={null}
    npm install @steerai/sdk
    ```

    TypeScript-fähiges SDK für Node.js und Browser
  </Card>
</CardGroup>

## Beispiel-Integrationen

### Grundlegender Inspektions-Workflow

```python theme={null}
from steer_ai import SteerAI

# Client initialisieren
client = SteerAI(api_key="YOUR_API_KEY")

# Inspektion erstellen
inspection = client.inspections.create({
    "vehicle": {
        "vin": "1HGBH41JXMN109186",
        "year": 2021,
        "make": "Honda",
        "model": "Civic"
    },
    "images": ["image1.jpg", "image2.jpg"]
})

# Ergebnisse abrufen
result = client.inspections.get(inspection.id)
print(f"Inspektion abgeschlossen: {result.status}")
print(f"Schäden erkannt: {result.damages}")
```

### Webhook-Integration

```python theme={null}
from flask import Flask, request
import hmac
import hashlib

app = Flask(__name__)

@app.route('/webhooks/steerai', methods=['POST'])
def handle_webhook():
    # Webhook-Signatur verifizieren
    signature = request.headers.get('X-SteerAI-Signature')
    body = request.get_data()

    if verify_signature(body, signature):
        event = request.json

        if event['type'] == 'inspection.completed':
            # Abgeschlossene Inspektion verarbeiten
            process_inspection_result(event['data'])

    return '', 200
```

## Fehlerbehandlung

### Häufige Fehlercodes

| Code  | Beschreibung      | Lösung                                          |
| ----- | ----------------- | ----------------------------------------------- |
| `400` | Bad Request       | Request-Format und Pflichtfelder prüfen         |
| `401` | Nicht autorisiert | API-Key und Berechtigungen prüfen               |
| `403` | Verboten          | Planlimits und Endpoint-Zugriff prüfen          |
| `404` | Not Found         | Resource-ID und Endpoint-URL prüfen             |
| `429` | Rate Limited      | Exponentielles Backoff implementieren           |
| `500` | Serverfehler      | Request erneut senden oder Support kontaktieren |

### Fehler-Response-Format

```json theme={null}
{
  "status": "error",
  "error": {
    "code": "INVALID_VIN",
    "message": "The provided VIN is invalid",
    "type": "validation_error",
    "field": "vehicle.vin"
  },
  "meta": {
    "request_id": "req_1234567890"
  }
}
```

## Best Practices

<AccordionGroup>
  <Accordion icon="shield" title="Sicherheit">
    • API-Keys niemals im Client-Code exponieren
    • Umgebungsvariablen für API-Keys verwenden
    • SSL-Zertifikate korrekt validieren
    • API-Keys regelmäßig rotieren (alle 90 Tage)
    • IP-Whitelisting nutzen, wenn möglich
  </Accordion>

  <Accordion icon="zap" title="Leistung">
    • Caching für wiederholte Requests implementieren
    • Batch-Endpunkte für mehrere Operationen nutzen
    • Rate Limits mit exponentiellem Backoff behandeln
    • Bildgrößen vor dem Upload optimieren
    • Kompression für große Payloads nutzen
  </Accordion>

  <Accordion icon="bug" title="Fehlerbehandlung">
    • Response-Statuscodes immer prüfen
    • Retry-Logik für temporäre Fehler implementieren
    • Fehlerdetails für Debugging protokollieren
    • Netzwerk-Timeouts sauber behandeln
    • Verständliche Fehlermeldungen an Nutzer geben
  </Accordion>

  <Accordion icon="chart-line" title="Überwachung">
    • API-Nutzung und Leistungskennzahlen tracken
    • Fehlerquoten und Antwortzeiten überwachen
    • Alerts für kritische Ausfälle einrichten
    • Request-IDs für Support-Tickets verwenden
    • Health-Checks für Ihre Integration implementieren
  </Accordion>
</AccordionGroup>

## Beispiel-Anwendungen

<CardGroup cols={2}>
  <Card title="Fahrzeuginspektions-App" icon="mobile">
    Vollständige mobile App für Vor-Ort-Inspektionen

    [Auf GitHub ansehen →](https://github.com/steerautos/mobile-inspector)
  </Card>

  <Card title="Autohaus-Integration" icon="building">
    Integration in ein komplettes Autohaus-Management-System

    [Auf GitHub ansehen →](https://github.com/steerautos/dealership-demo)
  </Card>
</CardGroup>

## Nächste Schritte

<CardGroup cols={3}>
  <Card title="Authentifizierung einrichten" icon="key" href="/de/integration/api/authentication">
    API-Keys und Sicherheit konfigurieren
  </Card>

  <Card title="Rate Limits" icon="gauge" href="/de/integration/api/rate-limits">
    Nutzungslimits und Optimierung verstehen
  </Card>

  <Card title="Fehlerbehandlung" icon="triangle-exclamation" href="/de/integration/api/error-handling">
    Robuste Fehlerbehandlung implementieren
  </Card>
</CardGroup>

## Support

Brauchen Sie Hilfe bei der API-Integration?

* **Dokumentation:** Vollständige API-Referenz mit Beispielen
* **SDKs:** Offizielle Bibliotheken für Python und JavaScript
* **Beispielcode:** Praxisnahe Integrationsbeispiele
* **Technischer Support:** [support@steerai.autos](mailto:support@steerai.autos)
* **Community:** [Discord-Community](https://discord.gg/steerai)

<Tip>
  **Profi-Tipp:** Starten Sie mit unserer Sandbox, um Ihre Integration vor dem Go-Live zu testen. Die meisten Entwickler schließen ihre erste Integration in unter 4 Stunden ab.
</Tip>