RoomPlanning für Entwickler

Stand: 11. November 2026

Baue Grundrisse in deine eigenen Produkte ein: Exposés, Möbelshops, Umzugsplaner, Kundenportale oder KI-Agenten. Die RoomPlanning Platform legt Pläne an, setzt Räume, Türen, Fenster und Möbel in echten Maßen, exportiert sie und bettet sie auf deiner Website ein. Jeder Plan liegt in deinem RoomPlanning-Konto und lässt sich im Editor weiterbearbeiten.

Die Platform steht allen mit einem RoomPlanning-Konto offen, für eigene Projekte ebenso wie für Unternehmen. Es gelten die Platform-Bedingungen.

Preise

Bezahlt wird mit Credits, ohne Abo und ohne Grundgebühr. Jedes Konto hat 50 Credits pro Monat gratis. Gekaufte Credits verfallen nicht. Die Preise sind Endpreise einschließlich MwSt.; Verkäufer ist Dodo Payments.

PaketCreditsPreis (inkl. MwSt.)je Credit
Starter50019 €3,8 ct
Growth2.50079 €3,2 ct
Scale10.000249 €2,5 ct
AufrufCredits
Lesen (Pläne, Plan beschreiben, Guthaben)0
Plan anlegen, Räume, Öffnungen, Einrichten, Geschosse, Treppen, Gelände, Abgrabungen, Rampen, Bodenaufbauten1
Export SVG oder PNG1
Export DXF2
Export GLB (3D-Modell)5
Geräte setzen (Netzwerk, Smart Home, Elektro)1
Netzwerk vorschlagen2
Installation prüfen; mit WLAN-Abdeckung (Premium)0; 1
Stückliste, Stückliste als CSV (Premium), Netzwerkplan als PDF1
Einbettung mit „Erstellt mit RoomPlanning“0 (bis 50.000 Aufrufe/Monat)
Einbettung ohne Hinweis1 je 100 Aufrufe

Ein fehlgeschlagener Aufruf kostet nichts. Ohne Credits antwortet die API mit 402 credits_exhausted.

Schnellstart

  1. Melde dich an und öffne die Entwickler-Konsole.
  2. Lege einen API-Schlüssel an. Er wird nur einmal angezeigt.
  3. Lege einen Plan an und gib ihm Räume:
curl -X POST https://roomplanning.app/platform/v1/plans \
  -H "Authorization: Bearer rp_live_…" -H "Content-Type: application/json" \
  -d '{"title": "Wohnung Musterstraße 1"}'

curl -X POST https://roomplanning.app/platform/v1/plans/PLAN_ID/rooms \
  -H "Authorization: Bearer rp_live_…" -H "Content-Type: application/json" \
  -d '{"rooms": [
        {"name": "Flur", "width_m": 1.5, "depth_m": 6},
        {"name": "Wohnzimmer", "width_m": 5, "depth_m": 4, "next_to": {"room": "Flur", "side": "east"}}
      ]}'

curl -o grundriss.png "https://roomplanning.app/platform/v1/plans/PLAN_ID/export.png?width=1600" \
  -H "Authorization: Bearer rp_live_…"

Jede Antwort eines bezahlten Aufrufs nennt in X-Credits-Charged, X-Free-Credits-Remaining und X-Credits-Remaining, was er gekostet hat und was übrig ist.

API-Referenz

Basis: https://roomplanning.app/platform/v1. Authentifizierung: Authorization: Bearer <API-Schlüssel>. Antworten in JSON, Maße in Metern. Bis zu 60 Aufrufe pro Minute und Schlüssel.

Methode und PfadWas
GET /meKonto, Gratis-Kontingent und Guthaben
GET /plans?q=Pläne des Kontos
POST /plansPlan anlegen: {title, units?}
GET /plans/{id}Plan beschreiben: Geschosse, Räume mit Fläche und Innenmaßen
POST /plans/{id}/roomsRäume: {rooms: [{name, width_m, depth_m, next_to?, at?}], level?}
POST /plans/{id}/openingsTüren, Fenster: {openings: [{room, side, kind, width_m?, offset_m?, style?, light_well?}], level?}
POST /plans/{id}/furnishRaum einrichten: {room, room_type?, density?}
POST /plans/{id}/levelsGeschoss oben oder Keller unten: {position: "above"|"below", name?, height_m?, slab_m?, copy_exterior_walls?}
POST /plans/{id}/stairsTreppe: {from?, to?, position: {x_m, y_m}, direction_deg?, kind?, width_m?}; to: "terrain" für eine Außentreppe
POST /plans/{id}/terrainGelände: {ground_level_m?, spot_heights?: [{x_m, y_m, height_m}], clear_spot_heights?}
POST /plans/{id}/excavationsAbgrabung vor dem Keller: {outline: [{x_m, y_m}], level?, floor_m?, edge?, railing?}
POST /plans/{id}/rampsRampe zur Tiefgarage: {points: [{x_m, y_m}], level?, from?, width_m?, top_m?, bottom_m?, transitions_m?, sides?}
POST /plans/{id}/floorsBodenaufbau einer Etage oder eines Raums: {level?, room?, preset?, layers?: [{kind, material?, thickness_mm, existing?, removed?, heating_pipe_mm?}], none?, name?, keep?: "heights"/"structure"}; Antwort mit OKFF, RFB und lichten Höhen
GET /plans/{id}/export.{svg,png,dxf,glb}Export; ?level= (Name oder Nummer), ?width= (PNG, bis 4096)
POST /plans/{id}/networkNetzwerk vorschlagen: {equipment_level?, levels?, access_points?, sat?, fiber?, smoke_detectors?, region?}
POST /plans/{id}/devicesGeräte nach Raum und Wand oder Decke: {devices: [{slug, room, side?, offset_m?, on?, label?, protocol?, supply?, watts?}], level?}
GET /plans/{id}/installation-checkAusstattung je Raum, Rauchmelder, Smart-Home-Hinweise, Kameras; ?level=, ?region=DE-BE, ?wifi=true (WLAN-Abdeckung je Raum, Premium)
GET /plans/{id}/bill-of-materialsStückliste als Tabellen (Premium); ?patch_list=true
GET /plans/{id}/export.{network-pdf,bom-csv}Netzwerkplan eines Geschosses als PDF (?level=), Stückliste als CSV (Premium)
POST /plans/{id}/embedsEinbettung anlegen: {branding?, domains?}
GET /embeds, DELETE /embeds/{id}Einbettungen auflisten, entfernen

level ist der Name eines Geschosses (Erdgeschoss, Kellergeschoss), eine Kurzform (EG, OG, KG, UG) oder eine Nummer (1 = unterstes); ohne level gilt das Erdgeschoss. Garagentore sind Türen mit style sectional, roller, up-and-over oder garage-side; light_well: {} setzt einen Lichtschacht vor ein Kellerfenster.

next_to legt einen Raum neben einen anderen: {"room": "Flur", "side": "east", "align": "start"}. side ist north, east, south oder west; align richtet am Anfang, in der Mitte oder am Ende der Seite aus. Gemeinsame Wände entstehen nur einmal.

Netzwerk und Smart Home: network setzt Doppeldosen je Raum nach dem Ausstattungswert (1 bis 3), den Medienverteiler, Access-Points (none, count oder coverage) und ein Cat.7-Kabel je Dose im Stern, auf Wunsch SAT, Glasfaser und Rauchmelder nach dem Bundesland. Listen und Berechnungen (Stückliste, WLAN-Abdeckung) gibt es wie im Editor mit Premium, sonst antwortet die API mit 403 pro_reports_required. Richtwerte, die Ausführung gehört in die Hände einer Elektrofachkraft.

Fehler kommen als {"error": "…", "message": "…"}, zum Beispiel 400 invalid_request, 401 unauthorized, 402 credits_exhausted, 404 not_found, 429 rate_limited (mit Retry-After).

Einbetten

Eine Einbettung zeigt einen Plan auf deiner Website und bleibt automatisch auf dem neuesten Stand:

<iframe
  src="https://roomplanning.app/embed/EMBED_ID"
  width="800"
  height="600"
  loading="lazy"
  style="border:0;max-width:100%"
  title="Grundriss"
></iframe>

Als Bild: https://roomplanning.app/embed/EMBED_ID.png oder .svg. Für Redaktionssysteme gibt es oEmbed unter https://roomplanning.app/oembed?url=…. Mit domains legst du fest, auf welchen Websites die Einbettung erscheinen darf.

Mit KI-Assistenten

Dieselben Pläne erreichst du auch aus Claude, ChatGPT und anderen Assistenten über den MCP-Server https://roomplanning.app/mcp: Pläne anlegen, einrichten, als Bild zeigen, exportieren und einbetten, Netzwerk und Smart Home planen und die Stückliste abrufen, im Chat.

Hinweise

Die API-Schlüssel gehören auf deinen Server, nicht in Code, der im Browser läuft. Einen Schlüssel kannst du in der Konsole jederzeit widerrufen; er funktioniert dann nach spätestens einer Minute nicht mehr.