---
title: "Öffentliche API für KI-Buchungen"
description: "Über die öffentliche Kunden-API kannst du Playrooms durchsuchen und Buchungen bis zu
einer gehosteten Zahlungssitzung erstellen – auch direkt über KI-Assistenten. Alle
Pfade liegen unter /v1/ und sind in Kleinbuchstaben gehalten."
canonical_url: "https://www.my-playrooms.de/de/content/api"
---

# Öffentliche API für KI-Buchungen

Über die öffentliche Kunden-API kannst du Playrooms durchsuchen und Buchungen bis zu
einer gehosteten Zahlungssitzung erstellen – auch direkt über KI-Assistenten. Alle
Pfade liegen unter `/v1/` und sind in Kleinbuchstaben gehalten.

## Öffentliche Endpunkte

Zum Suchen und Lesen ist **kein** API-Schlüssel nötig:

<table>
<thead>
  <tr>
    <th>
      Methode
    </th>
    
    <th>
      Pfad
    </th>
    
    <th>
      Beschreibung
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        GET
      </code>
    </td>
    
    <td>
      <code>
        /v1/playrooms
      </code>
    </td>
    
    <td>
      Playroom-Katalog durchsuchen (20 Einträge pro Seite)
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        GET
      </code>
    </td>
    
    <td>
      <code>
        /v1/playrooms/{urlPath}
      </code>
    </td>
    
    <td>
      Details zu einem Playroom
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        GET
      </code>
    </td>
    
    <td>
      <code>
        /v1/playrooms/{urlPath}/booking-options
      </code>
    </td>
    
    <td>
      Verfügbare Check-in-/Check-out-Zeiten und Preise
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        GET
      </code>
    </td>
    
    <td>
      <code>
        /v1/openapi.json
      </code>
    </td>
    
    <td>
      OpenAPI-Beschreibung der gesamten API
    </td>
  </tr>
</tbody>
</table>

## Buchung mit API-Schlüssel

Zum Anlegen und Bezahlen einer Buchung benötigst du einen API-Schlüssel, den du im `X-API-Key`-Header mitschickst:

<table>
<thead>
  <tr>
    <th>
      Methode
    </th>
    
    <th>
      Pfad
    </th>
    
    <th>
      Beschreibung
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        POST
      </code>
    </td>
    
    <td>
      <code>
        /v1/orders
      </code>
    </td>
    
    <td>
      Buchung anlegen (<code>
        Idempotency-Key
      </code>
      
       erforderlich)
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        GET
      </code>
    </td>
    
    <td>
      <code>
        /v1/orders/{orderId}
      </code>
    </td>
    
    <td>
      Status und Details einer Buchung
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        POST
      </code>
    </td>
    
    <td>
      <code>
        /v1/orders/{orderId}/payment
      </code>
    </td>
    
    <td>
      Zahlungslink für die Buchung erzeugen
    </td>
  </tr>
</tbody>
</table>

## API-Schlüssel erstellen

Erstelle und verwalte deine API-Schlüssel selbst in deinem Konto unter <user-api-keys-link>

API-Schlüssel

</user-api-keys-link>

. Der Schlüssel wird nur **einmal** angezeigt — bewahre ihn sicher auf. Buchungen, die über einen deiner Schlüssel entstehen, werden deinem Konto zugeordnet.

## OpenAPI-Spezifikation

Die vollständige, maschinenlesbare Beschreibung aller Endpunkte, Schemas und Fehlerfälle findest du unter <api-link path="/v1/openapi.json">

/v1/openapi.json

</api-link>

.

## MCP-Server

KI-Assistenten können dieselben Fähigkeiten auch über den MCP-Server nutzen: <api-link path="/mcp">

/mcp

</api-link>

. Er bietet die Tools `search_playrooms`, `get_playroom`, `get_booking_options`, `create_booking`, `get_booking` und `create_payment_session`.

## Regeln und Versionierung

- **Versionierung** erfolgt über den URL-Pfad (`/v1/`, später `/v2/`); alle Pfade sind lowercase.
- **Idempotenz:** `POST /v1/orders` erwartet einen `Idempotency-Key`-Header, damit wiederholte Aufrufe keine Doppelbuchung erzeugen.
- **Fehler:** Anwendungsfehler verwenden normalerweise `ProblemDetails` mit `title`, `status` und `detail`; verlasse dich nicht auf ein stabiles `code`-Feld.
- **Rate-Limit:** Die öffentliche API erlaubt 200 Anfragen pro 60 Sekunden, begrenzt pro API-Key oder Client-IP. Ein tägliches Limit ist nicht dokumentiert.
- **Webhooks:** Die öffentliche API bietet noch keine ausgehenden Buchungs-Webhooks. Frage den Order-Status über den Endpunkt ab.