API-Integrationsübersicht

# Registrieren und API-Keys erhalten
curl -X POST "https://api.steerai.autos/v1/auth/register" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "company": "Your Company Name"
  }'

# Authentifizierung testen
curl -X GET "https://api.steerai.autos/v1/auth/test" \
  -H "Authorization: Bearer YOUR_API_KEY"

# 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"
    ]
  }'

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

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1640995200
X-Retry-After: 60

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}")

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

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