xmoo Cable Sizing API

Was sie kann

• Kabelberechnung aus Betriebsstrom oder Leistung: Schutzorgan (I_b ≤ I_n ≤ I_z, I₂ ≤ 1,45 I_z), Querschnitt aus der Belastbarkeit mit Umrechnungsfaktoren für Temperatur und Häufung, Spannungsfall, Schleifenimpedanz und Abschaltung, Kurzschlussfestigkeit. Verlangen Spannungsfall oder Abschaltung mehr, wird der Querschnitt selbst erhöht.
• Belastbarkeit für eine Verlegung: Tabellenwert und umgerechneter Wert für jeden Querschnitt oder der kleinste, der einen Strom trägt.
• Spannungsfall einer Leitung, die größte Länge innerhalb der Grenze und der kleinste Querschnitt, der sie einhält.

Jede Antwort nennt Norm, Tabelle und Spalte und führt die Rechnung Schritt für Schritt als Text auf – bereit zum Anzeigen oder für einen Bericht. Gespeichert wird nichts. Es ist derselbe Kern wie bei der kostenlosen Kabelberechnung hier.

Die Dokumentation ist auf Englisch maßgeblich: Cable Sizing API (English). Feldnamen und Standardtexte sind englisch, mit lang=de kommen die Texte auf Deutsch.

Normen

Belastbarkeiten und Umrechnungsfaktoren stammen aus DIN VDE 0298-4:2023-06 (Tabellen 3–6, 17, 20–26, 29). Deren Werte sind die der HD 60364-5-52 / IEC 60364-5-52 Anhang B, die API passt also für jedes Land, das diese Tabellen nutzt. Die Rechnung folgt IEC 60364-4-43 (Überlastschutz), IEC 60364-5-52 (Spannungsfall, ohmscher Anteil) und IEC 60364-4-41 (Abschaltung) mit dem kleinsten einpoligen Fehlerstrom nach IEC 60909-0 (c_min = 0,9, Leiter bei zulässiger Kurzschlusstemperatur). Netzspannung 230 V / 400 V.

• Kupfer und Aluminium (Aluminium ab 25 mm²), PVC 70 °C und vernetzte Isolierung 90 °C.
• Referenzverlegearten A1 bis G, Querschnitte bis 300 mm² (F und G bis 630 mm²).
• Schutzorgane: Leitungsschutzschalter B, C, D bis 63 A, gG-Sicherungen bis 250 A; TN- und TT-System.

Die API ist eine Planungshilfe ohne Gewähr. Sie ersetzt weder die fachgerechte Planung noch die Prüfung nach DIN VDE 0100-600 (IEC 60364-6). Nationale Abweichungen von diesen Tabellen sind nicht berücksichtigt – maßgeblich sind die Regeln am Ort der Errichtung.

Zugang

Die API wird über RapidAPI angeboten; dort wählst du einen Tarif und bekommst Schlüssel und Hostnamen. Der Eintrag ist in Vorbereitung – der Link steht hier, sobald er online ist. Fragen: julian@haag-automation.com.

Alle Endpunkte nehmen und liefern JSON (Content-Type: application/json, Body bis 64 KB). Die Beispiele erwarten Schlüssel und Host in RAPIDAPI_KEY und RAPIDAPI_HOST.

Endpunkte

Felder im Einzelnen: api.xmoo.app/electrical/openapi.json (OpenAPI 3.0).

Beispiele

Echte Antworten der API, wo vermerkt gekürzt. Ein Test bei uns schickt diese Anfragen und prüft, dass die Antworten noch stimmen.

Zuleitung einer Unterverteilung

50 kW Drehstrom bei cos φ 0,95, 30 m, Verlegeart C, 35 °C, gG-Sicherung, Verteilerstromkreis, 100 mΩ Schleifenimpedanz bis zum Anfang des Stromkreises:

curl -s -X POST "https://$RAPIDAPI_HOST/v1/electrical/cable/size" \
  -H "x-rapidapi-key: $RAPIDAPI_KEY" \
  -H "x-rapidapi-host: $RAPIDAPI_HOST" \
  -H "Content-Type: application/json" \
  -d @anfrage.json

{
  "supply": "three-phase",
  "power": 50000,
  "powerFactor": 0.95,
  "length": 30,
  "installationMethod": "C",
  "ambientTemperature": 35,
  "protectiveDevice": "gG",
  "circuitType": "distribution",
  "upstreamImpedance": 100
}

Antwort, gekürzt auf die Hauptergebnisse und den ersten von sechs Schritten:

{
  "status": "ok",
  "result": {
    "designCurrent": 75.97,
    "protectiveDevice": {
      "type": "gG",
      "ratedCurrent": 80,
      "conventionalCurrentI2": 128
    },
    "requiredCurrentCapacity": 88.28,
    "crossSection": 25,
    "tabulatedCapacity": 96,
    "currentCapacity": 90.24,
    "factors": {
      "temperature": 0.94,
      "grouping": 1
    },
    "voltageDrop": {
      "volts": 2.68,
      "percent": 0.67,
      "ok": true
    },
    "disconnection": {
      "maxTime": 5,
      "disconnectionCurrent": 440,
      "loopImpedance": 0.1669,
      "minShortCircuitCurrent": 1240.58,
      "ok": true
    },
    "shortCircuit": {
      "k": 115,
      "permissibleTime": 5.37,
      "ok": true
    },
    "recommendation": {
      "text": "NYM-J 5×25 mm², 3 × gG 80 A (e.g. NEOZED D03 or NH size 000/00)"
    }
  },
  "sources": {
    "standard": "DIN VDE 0298-4:2023-06",
    "table": "Table 3",
    "hd60364552": "B.52.4/6"
  },
  "steps": [
    {
      "step": 1,
      "title": "Design current Ib",
      "standard": null,
      "status": "ok",
      "lines": [
        "Ib = P ÷ (√3 × U × cos φ) = 50,000 W ÷ (1.732 × 400 V × 0.95) = 75.97 A"
      ],
      "nextStep": null
    }
  ],
  "notice": "Planning aid without warranty; it replaces neither professional design nor verification to IEC 60364-6."
}

status ist ok, wenn alle Nachweise erfüllt sind, failed, wenn eine Bedingung nicht erfüllt ist (der Schritt sagt dann in nextStep, was zu tun ist), incomplete, wenn ein Schritt nicht prüfbar war – etwa ohne upstreamImpedance –, und note, wenn der Kurzschlussnachweis einen Herstellerwert braucht.

Spannungsfall eines Endstromkreises

16 A Wechselstrom, 25 m, 1,5 mm² Kupfer:

{
  "supply": "single-phase",
  "current": 16,
  "length": 25,
  "crossSection": 1.5
}

{
  "designCurrent": 16,
  "voltage": 230,
  "conductivity": 56,
  "voltageDrop": {
    "volts": 9.52,
    "percent": 4.14,
    "ok": false
  },
  "maxLength": 24.15,
  "smallestCrossSectionWithinLimit": {
    "crossSection": 2.5,
    "volts": 5.71,
    "percent": 2.48
  },
  "formula": "ΔU = 2 × L × I × cos φ ÷ (κ × A)",
  "note": "Resistive part only, conductor at 20 °C; the inductive reactance of large cross-sections is not included."
}

4,14 % liegt über der Standardgrenze von 4 %: Die Leitung darf höchstens 24,15 m lang sein, oder 2,5 mm² halten den Spannungsfall bei 2,48 %.

Welcher Querschnitt trägt 32 A?

Verlegeart B2, drei belastete Adern, 40 °C Umgebung:

{
  "installationMethod": "B2",
  "loadedConductors": 3,
  "ambientTemperature": 40,
  "requiredCurrent": 32
}

Antwort, gekürzt auf die ersten drei Querschnitte der Liste:

{
  "conductor": "copper",
  "insulation": "pvc-70",
  "column": {
    "installationMethod": "B2",
    "loadedConductors": 3,
    "arrangement": null
  },
  "factors": {
    "temperature": 0.87,
    "grouping": 1,
    "soil": null,
    "groupingCircuitsInTable": 1,
    "total": 0.87
  },
  "smallestSufficient": {
    "crossSection": 10,
    "tabulatedCapacity": 46,
    "currentCapacity": 40.02
  },
  "capacities": [
    {
      "crossSection": 1.5,
      "tabulatedCapacity": 15,
      "currentCapacity": 13.05
    },
    {
      "crossSection": 2.5,
      "tabulatedCapacity": 20,
      "currentCapacity": 17.4
    },
    {
      "crossSection": 4,
      "tabulatedCapacity": 27,
      "currentCapacity": 23.49
    }
  ],
  "sources": {
    "standard": "DIN VDE 0298-4:2023-06",
    "table": "Table 3",
    "hd60364552": "B.52.4/5",
    "factors": [
      "Table 17",
      "Table 22"
    ]
  }
}

Fehler

Fehler kommen als JSON mit code, message und bei Eingabefehlern dem field:

{
  "error": {
    "code": "missing_field",
    "message": "\"crossSection\" is required.",
    "field": "crossSection"
  }
}

Mit KI-Agenten (MCP)

RapidAPI stellt seine APIs auch als Werkzeuge für KI-Agenten über das Model Context Protocol (MCP) bereit. Mit deinem RapidAPI-Schlüssel kann ein Agent ein Kabel als Werkzeugaufruf bemessen – und dem Nutzer die Schritte dahinter zeigen.

Datenschutz und Bedingungen

Die Eingaben sind technische Werte; gespeichert wird nichts. Datenschutzhinweise der API · Nutzungsbedingungen · Auftragsverarbeitungsvertrag.

Anbieter

Haag Automation, Julian Haag, Mühlstraße 35, 74360 Ilsfeld · julian@haag-automation.com · xmoo ist eine Marke von Haag Automation. Alle APIs