AIX Aleph API Dokumentation

Übersicht

Die AIX Aleph API ermöglicht den sicheren Zugriff auf unsere Hybrid-Intelligenzplattform mit:

• Echtzeit-Datenströmen aus Smart City Infrastrukturen
• Vorhersagemodellen mit Quantum AI Unterstützung
• IoT-Gerätesteuerung für Smart City Anwendungen
• Historische Datenanalyse und Reporting

Authentifizierung

Alle API-Anfragen erfordern einen gültigen JWT-Token, den Sie über den Authentifizierungsendpunkt erhalten.

curl -X POST https://api.ahzami.de/auth/token \
-H "Content-Type: application/json" \
-d '{"username":"your_username","password":"your_password"}'

{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expires_in": 3600
}

Verwenden Sie den erhaltenen Token in allen nachfolgenden Anfragen im Authorization Header:

Authorization: Bearer your_token_here

API Endpunkte

curl -X GET "https://api.ahzami.de/api/data/realtime?type=sensor&location=city_center" \
-H "Authorization: Bearer your_token_here"

{
  "timestamp": "2025-04-07T14:23:45Z",
  "data": {
    "temperature": 22.5,
    "humidity": 60,
    "air_quality": 45,
    "location": "city_center"
  }
}

curl -X GET "https://api.ahzami.de/api/data/history?type=traffic&start_date=2025-01-01&end_date=2025-01-31" \
-H "Authorization: Bearer your_token_here"

{
  "data": [
    {
      "timestamp": "2025-01-01T08:00:00Z",
      "traffic_density": 320,
      "average_speed": 42.5
    },
    {
      "timestamp": "2025-01-01T09:00:00Z",
      "traffic_density": 450,
      "average_speed": 32.1
    }
  ]
}

curl -X POST "https://api.ahzami.de/api/ai/prediction" \
-H "Authorization: Bearer your_token_here" \
-H "Content-Type: application/json" \
-d '{
  "input_data": {
    "temperature": 22.5,
    "humidity": 60,
    "time_of_day": "morning"
  }
}'

{
  "prediction": {
    "traffic_delay": 15,
    "energy_demand": 2450,
    "confidence": 0.87
  }
}

Fehlerbehandlung

Rate Limits

Zum Schutz unserer Systeme gelten folgende Anfragebegrenzungen:

• Standard: 1.000 Anfragen/Minute, 10.000 Anfragen/Tag
• Enterprise: 5.000 Anfragen/Minute, 50.000 Anfragen/Tag

Bei Überschreitung erhalten Sie eine 429 Fehlermeldung. Bitte implementieren Sie eine Backoff-Strategie.

Support

Für technischen Support kontaktieren Sie bitte:

• E-Mail: support@ahzami.de
• Telefon: +49 123 456789 (Mo-Fr, 9-17 Uhr)
• Developer Portal: dev.ahzami.de