# My Playrooms

> My Playrooms ist eine seit 2022 bestehende Online-Plattform zur Buchung von Playrooms und BDSM-Locations in Deutschland — mit Gästebuchung, Gastgeber-Verwaltung und integrierter Zahlungsabwicklung.
>
> **Maschinenlesbar:** [bot-index.json](https://www.my-playrooms.de/bot-index.json) (JSON — für Bots und KI-Agenten optimiert)

## Pages

- [Startseite](https://www.my-playrooms.de) — Playrooms suchen, Gästebuchung und Gastgeber-Registrierung
- [Playrooms](https://www.my-playrooms.de/playrooms) — Alle Playrooms durchsuchen (filterbar nach Ort, Buchungsart, Gästeanzahl)
- [Gutscheine](https://www.my-playrooms.de/gutscheine) — Gutscheine kaufen und einlösen
- [Ratgeber](https://www.my-playrooms.de/ratgeber) — Ratgeber-Artikel (BDSM A-Z, Grundbegriffe, Spielzeuge, Sauberkeit, Diskretion)
- [Impressum](https://www.my-playrooms.de/impressum) — Impressum und rechtliche Angaben
- [AGB](https://www.my-playrooms.de/agb) — Allgemeine Geschäftsbedingungen
- [Datenschutz](https://www.my-playrooms.de/datenschutz) — Datenschutzerklärung
- [Support](https://www.my-playrooms.de/support) — Support-Team kontaktieren

## Features

### Für Gäste
- **Playrooms suchen**: Filtern nach Ort, Buchungsart (stündlich/Übernachtung), Gästeanzahl
- **Buchen**: Direkte Online-Buchung mit Zahlungsabwicklung
- **Gutscheine**: Kauf und Einlösung von Geschenkgutscheinen
- **Bewertungen**: Playrooms bewerten nach Besuch
- **Diskretion**: DSGVO-konform, private Daten geschützt

### Für Gastgeber
- **Raumverwaltung**: Playrooms anlegen, bearbeiten, verwalten inkl. Verfügbarkeitskalender
- **Preise & Buchungsregeln**: Individuelle Preise pro Stunde/Übernachtung, Reinigungszeiten, Mindestbuchungsdauer
- **Buchungssteuerung**: Buchungen annehmen/ablehnen, Gästekommunikation
- **Auswertungen**: Statistiken zu Besuchen, Umsatz, Auslastung
- **Rabattaktionen**: Last-Minute-Rabatte, Stammgast-Rabatte verwalten
- **Rechnungen**: Automatische Rechnungsstellung (PDF) inkl. Provisionsabrechnung
- **Einrichtungsservice**: Unterstützung bei der Playroom-Erstellung
- **Integration**: Komplett integriert — keine eigene Webseite nötig

### Buchungsarten
- **Stundenbuchung (Hourly)**: Kurze Mietzeiträume, stündliche Abrechnung
- **Übernachtung (Overnight)**: Ganze Nächte/Tage buchbar, Übernachtungspreise

### Preise & Gebühren
- **Grundgebühr**: Monatliche Basisgebühr pro aktivem Playroom
- **Provision**: Umsatzabhängige Provision pro gebuchter Order
- **Gastgeber**: Volle Kostenkontrolle, Preise frei wählbar
- **Gäste**: Keine versteckten Gebühren, transparenter Buchungspreis

## API

### Öffentliche API (v1) — für KI-Agenten

Die öffentliche Kunden-API erlaubt es, Playrooms zu durchsuchen und Buchungen bis zur Bezahlung auszulösen — ideal für KI-Assistenten, die für Nutzer buchen.

**Basis-URL:** https://api.my-playrooms.de
**OpenAPI-Spezifikation:** https://api.my-playrooms.de/v1/openapi.json
**MCP-Server:** https://api.my-playrooms.de/mcp
**Dokumentation:** https://www.my-playrooms.de/content/api

#### Öffentliche Endpunkte (kein API-Schlüssel nötig)

- `GET /v1/playrooms` — Playroom-Katalog durchsuchen (paginiert)
- `GET /v1/playrooms/{urlPath}` — Playroom-Details
- `GET /v1/playrooms/{urlPath}/booking-options` — Verfügbare Check-in/Check-out-Zeiten und Preise

#### Buchungs-Endpunkte (X-API-Key erforderlich)

- `POST /v1/orders` — Buchung anlegen (idempotent über den `Idempotency-Key`-Header)
- `GET /v1/orders/{orderId}` — Buchungsstatus und Details
- `POST /v1/orders/{orderId}/payment` — Zahlungslink für die Buchung erzeugen

API-Schlüssel werden self-service im eigenen Konto vergeben (https://www.my-playrooms.de/user/api-keys) und nur einmal angezeigt. Buchungen, die über einen Schlüssel entstehen, werden dem Besitzer des Schlüssels zugeordnet.

### Interne API (Website-Frontend)

Die interne API verwendet JWT-Bearer-Tokens. Registrierte Nutzer erhalten nach Login ein Token für authenticated requests.

#### Endpunkte

- `GET /api/Public/Playrooms` — Alle Playrooms mit Filterung, Paginierung, Sortierung
- `GET /api/Public/Playrooms/{id}` — Detailansicht eines Playrooms
- `GET /api/Public/Playrooms/AvailableLists` — Verfügbare Zeitslots für einen Playroom
- `GET /api/Public/Playrooms/Search` — Volltext-Suche über Playrooms
- `POST /api/Public/Orders` — Buchung erstellen
- `POST /api/Public/Vouchers/Code/{code}` — Gutschein-Code einlösen
- `GET /api/Owner/Playrooms` — Eigene Playrooms abrufen (Gastgeber)
- `POST /api/Auth/Login` — Benutzer-Login
- `POST /api/Auth/Register` — Benutzer-Registrierung

### Integrationen
- **Zahlung**: Stripe (Kreditkarte), Unzer (Sepa, PayPal, Kreditkarte auf Raten)
- **E-Mail**: Brevo (Transaktions-Mails, Newsletter)
- **Kalender**: iCal-Export für Google Calendar, Outlook, Apple Calendar
- **Smart Home**: Igloohome Bridge (Keypad-Locks), Philips Hue (Lichtsteuerung)
- **Karten**: OpenStreetMap über Azure Maps (Geocoding), Google Static Maps
- **Monitoring**: GlitchTip (Sentry-kompatibel), Serilog (Loki/Grafana)

## Allgemeine Informationen

### Plattform
- **Gründung**: 2022
- **Reichweite**: Deutschland (Bundesländer: Berlin, Hamburg, München, Köln, Frankfurt, Stuttgart, Düsseldorf, Leipzig, Dortmund, Essen, Bremen, Nordrhein-Westfalen, Bayern, Baden-Württemberg, Niedersachsen, Hessen, Rheinland-Pfalz, Sachsen, Schleswig-Holstein, Brandenburg)
- **Sprache**: Deutsch (DE), Englisch (EN)
- **Diskretion**: DSGVO-konform, Privatsphäre hat höchste Priorität

### Presse
My Playrooms wurde bereits in Playboy, Schlagzeilen und Kunst und Sünde vorgestellt.

### Partner
- Blacksurprise
- Fetisch.Gmbh
- Erotik Webagentur

### Social Media
- Instagram: @my_playrooms
- YouTube: My Playrooms
- Fetlife: My Playrooms Community

### Support
Kontakt über My Playrooms — auf der Website unter /support oder direkt über das Support-Formular.