Zum Hauptinhalt springen

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.

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:
curl -X GET "https://api.steerai.autos/v1/inspections" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
Sicherheitshinweis: Geben Sie Ihre API-Schlüssel niemals in clientseitigem Code preis. Verwenden Sie für Produktiv-Anwendungen immer serverseitige Implementierungen.

Anfrage-/Antwortformat

Anfrage-Header

Alle Anfragen sollten diese Header enthalten:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
User-Agent: YourApp/1.0

Antwortformat

Alle API-Antworten folgen dieser einheitlichen Struktur:
{
  "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

Ratenlimits

Ratenlimits gelten pro API-Schlüssel und variieren je nach Plan:
PlanAnfragen/StundeGleichzeitigBurst-Limit
Kostenlos1,000550
Starter10,00020200
Professional100,0001001,000
EnterpriseUnbegrenztIndividuellIndividuell

SDKs und Bibliotheken

Python SDK

pip install steer-ai
Voll ausgestattete Python-Bibliothek mit Async-Support

JavaScript SDK

npm install @steerai/sdk
TypeScript-fähiges SDK für Node.js und Browser

Beispielanfragen

Fahrzeuginspektion

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

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

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": "[email protected]",
    "phone": "+1234567890",
    "source": "website"
  }'

Fehlerbehandlung

Alle API-Antworten folgen einem einheitlichen Fehlerformat:
{
  "status": "error",
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid VIN format",
    "type": "validation_error",
    "field": "vehicle.vin"
  },
  "meta": {
    "request_id": "req_1234567890abcdef"
  }
}

Häufige Fehlercodes

CodeHTTP-StatusBeschreibung
INVALID_API_KEY401API-Schlüssel ist ungültig oder abgelaufen
RATE_LIMIT_EXCEEDED429Zu viele Anfragen
VALIDATION_ERROR400Anfrage-Daten sind ungültig
RESOURCE_NOT_FOUND404Angeforderte Ressource existiert nicht
INTERNAL_ERROR500Serverfehler, Anfrage erneut senden

Webhooks

Konfigurieren Sie Webhooks, um Updates in Echtzeit zu erhalten:
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