> ## 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-Referenz

> Vollständige REST-API-Dokumentation für Steer AIs Plattform für Fahrzeuginspektion und Preisfindung

## Willkommen bei der Steer-AI-API

Die Steer-AI-API bietet programmgesteuerten Zugriff auf unsere KI-gestützte Plattform für Fahrzeuginspektion, Preisfindung und CRM. Erstellen Sie individuelle Integrationen, automatisieren Sie Abläufe und bauen Sie leistungsstarke Automotive-Anwendungen.

<CardGroup cols={2}>
  <Card title="Schnellstart" icon="rocket" href="/de/getting-started/quickstart">
    Holen Sie sich Ihre API-Schlüssel und stellen Sie Ihre erste Anfrage in wenigen Minuten
  </Card>

  <Card title="Authentifizierung" icon="key" href="/de/getting-started/authentication">
    Sichern Sie Ihre API-Anfragen mit der richtigen Authentifizierung ab
  </Card>

  <Card title="Integrationsleitfaden" icon="plug" href="/de/integration/api/overview">
    Vollständiger Leitfaden zur API-Integration und bewährten Praktiken
  </Card>

  <Card title="Bewährte Praktiken" icon="star" href="/de/guides/best-practices">
    Leitlinien zu Sicherheit, Leistung und Optimierung
  </Card>
</CardGroup>

## Basis-URL

Alle API-Endpunkte sind relativ zur Basis-URL:

**Production:** `https://api.steerai.autos/v1`

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

## Authentifizierung

Alle API-Anfragen erfordern Authentifizierung per Bearer-Token:

```bash theme={null}
curl -X GET "https://api.steerai.autos/v1/inspections" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
```

<Warning>
  **Sicherheitshinweis:** Geben Sie Ihre API-Schlüssel niemals in clientseitigem Code preis. Verwenden Sie für Produktiv-Anwendungen immer serverseitige Implementierungen.
</Warning>

## Anfrage-/Antwortformat

### Anfrage-Header

Alle Anfragen sollten diese Header enthalten:

```http theme={null}
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
User-Agent: YourApp/1.0
```

### Antwortformat

Alle API-Antworten folgen dieser einheitlichen Struktur:

```json theme={null}
{
  "status": "success",
  "data": {
    // Response data here
  },
  "meta": {
    "request_id": "req_1234567890abcdef",
    "timestamp": "2024-01-15T10:30:00Z",
    "processing_time": 1.234,
    "rate_limit": {
      "limit": 1000,
      "remaining": 999,
      "reset": 1640995200
    }
  }
}
```

## Zentrale API-Endpunkte

<CardGroup cols={3}>
  <Card title="Fahrzeuginspektion" icon="search" href="/de/features/inspection/overview">
    Fahrzeuge zur KI-gestützten Inspektion und Schadensanalyse einreichen
  </Card>

  <Card title="Preisfindung & Bewertung" icon="dollar-sign" href="/de/features/pricing/overview">
    Marktwerte in Echtzeit und Schadenseinfluss-Berechnungen erhalten
  </Card>

  <Card title="CRM-Verwaltung" icon="users" href="/de/features/crm/overview">
    Leads, Kunden und Bestand über unsere CRM-APIs verwalten
  </Card>
</CardGroup>

## Ratenlimits

Ratenlimits gelten pro API-Schlüssel und variieren je nach Plan:

| Plan             | Anfragen/Stunde | Gleichzeitig | Burst-Limit |
| ---------------- | --------------- | ------------ | ----------- |
| **Kostenlos**    | 1,000           | 5            | 50          |
| **Starter**      | 10,000          | 20           | 200         |
| **Professional** | 100,000         | 100          | 1,000       |
| **Enterprise**   | Unbegrenzt      | Individuell  | Individuell |

## SDKs und Bibliotheken

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

    Voll ausgestattete Python-Bibliothek mit Async-Support
  </Card>

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

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

## Beispielanfragen

### Fahrzeuginspektion

```bash theme={null}
curl -X POST "https://api.steerai.autos/v1/inspections" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "vehicle": {
      "vin": "1HGBH41JXMN109186",
      "make": "Honda",
      "model": "Civic",
      "year": 2021
    },
    "inspection_type": "full"
  }'
```

### Preisbewertung

```bash theme={null}
curl -X POST "https://api.steerai.autos/v1/pricing/valuate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "vehicle_id": "veh_1234567890",
    "mileage": 50000,
    "condition": "good"
  }'
```

### CRM-Lead-Erstellung

```bash theme={null}
curl -X POST "https://api.steerai.autos/v1/crm/leads" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "John Doe",
    "email": "john@example.com",
    "phone": "+1234567890",
    "source": "website"
  }'
```

## Fehlerbehandlung

Alle API-Antworten folgen einem einheitlichen Fehlerformat:

```json theme={null}
{
  "status": "error",
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid VIN format",
    "type": "validation_error",
    "field": "vehicle.vin"
  },
  "meta": {
    "request_id": "req_1234567890abcdef"
  }
}
```

### Häufige Fehlercodes

| Code                  | HTTP-Status | Beschreibung                               |
| --------------------- | ----------- | ------------------------------------------ |
| `INVALID_API_KEY`     | 401         | API-Schlüssel ist ungültig oder abgelaufen |
| `RATE_LIMIT_EXCEEDED` | 429         | Zu viele Anfragen                          |
| `VALIDATION_ERROR`    | 400         | Anfrage-Daten sind ungültig                |
| `RESOURCE_NOT_FOUND`  | 404         | Angeforderte Ressource existiert nicht     |
| `INTERNAL_ERROR`      | 500         | Serverfehler, Anfrage erneut senden        |

## Webhooks

Konfigurieren Sie Webhooks, um Updates in Echtzeit zu erhalten:

```bash theme={null}
curl -X POST "https://api.steerai.autos/v1/webhooks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-app.com/webhooks/steerai",
    "events": ["inspection.completed", "pricing.calculated"]
  }'
```

## Support

* **Technischer Support:** [support@steerai.autos](mailto:support@steerai.autos)
* **API-Status:** [status.steerai.autos](https://status.steerai.autos)
* **Changelog:** Siehe unser [Änderungsprotokoll](/de/support/changelog) für API-Updates