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.
| Paket | Credits | Preis (inkl. MwSt.) | je Credit |
|---|---|---|---|
| Starter | 500 | 19 € | 3,8 ct |
| Growth | 2.500 | 79 € | 3,2 ct |
| Scale | 10.000 | 249 € | 2,5 ct |
| Aufruf | Credits |
|---|---|
| Lesen (Pläne, Plan beschreiben, Guthaben) | 0 |
| Plan anlegen, Räume, Öffnungen, Einrichten, Geschosse, Treppen, Gelände, Abgrabungen, Rampen, Bodenaufbauten | 1 |
| Export SVG oder PNG | 1 |
| Export DXF | 2 |
| Export GLB (3D-Modell) | 5 |
| Geräte setzen (Netzwerk, Smart Home, Elektro) | 1 |
| Netzwerk vorschlagen | 2 |
| Installation prüfen; mit WLAN-Abdeckung (Premium) | 0; 1 |
| Stückliste, Stückliste als CSV (Premium), Netzwerkplan als PDF | 1 |
| Einbettung mit „Erstellt mit RoomPlanning“ | 0 (bis 50.000 Aufrufe/Monat) |
| Einbettung ohne Hinweis | 1 je 100 Aufrufe |
Ein fehlgeschlagener Aufruf kostet nichts. Ohne Credits antwortet die API mit 402 credits_exhausted.
Schnellstart
- Melde dich an und öffne die Entwickler-Konsole.
- Lege einen API-Schlüssel an. Er wird nur einmal angezeigt.
- 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 Pfad | Was |
|---|---|
GET /me | Konto, Gratis-Kontingent und Guthaben |
GET /plans?q= | Pläne des Kontos |
POST /plans | Plan anlegen: {title, units?} |
GET /plans/{id} | Plan beschreiben: Geschosse, Räume mit Fläche und Innenmaßen |
POST /plans/{id}/rooms | Räume: {rooms: [{name, width_m, depth_m, next_to?, at?}], level?} |
POST /plans/{id}/openings | Türen, Fenster: {openings: [{room, side, kind, width_m?, offset_m?, style?, light_well?}], level?} |
POST /plans/{id}/furnish | Raum einrichten: {room, room_type?, density?} |
POST /plans/{id}/levels | Geschoss oben oder Keller unten: {position: "above"|"below", name?, height_m?, slab_m?, copy_exterior_walls?} |
POST /plans/{id}/stairs | Treppe: {from?, to?, position: {x_m, y_m}, direction_deg?, kind?, width_m?}; to: "terrain" für eine Außentreppe |
POST /plans/{id}/terrain | Gelände: {ground_level_m?, spot_heights?: [{x_m, y_m, height_m}], clear_spot_heights?} |
POST /plans/{id}/excavations | Abgrabung vor dem Keller: {outline: [{x_m, y_m}], level?, floor_m?, edge?, railing?} |
POST /plans/{id}/ramps | Rampe zur Tiefgarage: {points: [{x_m, y_m}], level?, from?, width_m?, top_m?, bottom_m?, transitions_m?, sides?} |
POST /plans/{id}/floors | Bodenaufbau 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}/network | Netzwerk vorschlagen: {equipment_level?, levels?, access_points?, sat?, fiber?, smoke_detectors?, region?} |
POST /plans/{id}/devices | Geräte nach Raum und Wand oder Decke: {devices: [{slug, room, side?, offset_m?, on?, label?, protocol?, supply?, watts?}], level?} |
GET /plans/{id}/installation-check | Ausstattung je Raum, Rauchmelder, Smart-Home-Hinweise, Kameras; ?level=, ?region=DE-BE, ?wifi=true (WLAN-Abdeckung je Raum, Premium) |
GET /plans/{id}/bill-of-materials | Stü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}/embeds | Einbettung 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.