Zum Hauptinhalt springen

Format

Alle Fehlerantworten haben dieselbe Struktur:
{
  "error": {
    "code": "LOCATION_NOT_FOUND",
    "message": "Location 123 was not found for the provided tenant",
    "requestId": "b1f6e6b0-1234-4abc-9def-000000000000"
  }
}
requestId ist pro Anfrage eindeutig — gib sie an, wenn du den RiDERgy Support zu einem bestimmten Fehler kontaktierst.

Fehlercodes

CodeHTTP-StatusBedeutung
UNAUTHORIZED401API-Schlüssel fehlt, ist ungültig, inaktiv oder abgelaufen.
FEATURE_NOT_ENABLED403Die Energy Management API ist für deinen Mandanten nicht aktiviert.
INVALID_REQUEST_BODY400Im Request-Body fehlen Pflichtfelder, das JSON ist ungültig, oder die Validierung schlägt fehl (z. B. limitKw <= 0, endTime <= startTime, endTime liegt in der Vergangenheit, priority außerhalb von 0–10).
TARGET_INACTIVE400Der Zielstandort ist als inaktiv markiert.
LOCATION_NOT_FOUND404Es existiert kein Standort mit der angegebenen locationId für deinen Mandanten.
CHARGER_NOT_FOUND404Es existiert kein Connector mit der angegebenen controllerUuid/connectorId für deinen Mandanten.
CLUSTER_NOT_FOUND404Es existiert kein Cluster mit der angegebenen clusterId für deinen Mandanten.
CLUSTER_INACTIVE400Der status des Clusters ist INACTIVE.
CLUSTER_EMPTY400Der Cluster enthält keine Standorte.
NOT_FOUND404Die Kombination aus Pfad und Methode ist kein gültiger Endpunkt.
INTERNAL_ERROR500Unerwarteter serverseitiger Fehler.