Tutorials

How To Use API V2 Beds24 – Der ultimative Guide 2025 (Step-by-Step)

Melden

Hier ist ein umfassendes Step-by-Step Tutorial zur Nutzung der Beds24 API V2 (Stand 2025) auf Deutsch.

Die Beds24 API V2 ist das leistungsstarke Herzstück für alle, die ihr Channel-Management automatisieren, eigene Frontends bauen oder Drittanbieter-Software anbinden möchten. Im Gegensatz zu V1 ist sie moderner (REST-basiert) und nutzt ausschließlich JSON.

Schritt 1: Voraussetzungen schaffen

Bevor du den ersten Request sendest, musst du sicherstellen, dass dein Beds24-Account für die API-Nutzung bereit ist.

  1. Account-Typ: Du benötigst einen aktiven Beds24-Account.
  2. API-Freischaltung:
    • Gehe in Beds24 zu Einstellungen > Account > API.
    • Stelle sicher, dass der Zugriff erlaubt ist.
  3. Sub-Account (Empfohlen): Für maximale Sicherheit solltest du einen Sub-Account anlegen (Einstellungen > Account > Sub-Accounts), der nur die Berechtigungen hat, die du wirklich benötigst (z.B. nur Leserechte für Buchungen).

Schritt 2: Authentifizierung (API-Keys erstellen)

In der Version 2 nutzt Beds24 Account-Token.

  1. Gehe zu Einstellungen > Account > API.
  2. Suche den Bereich API V2.
  3. Hier kannst du einen Account Token generieren.
    • Wichtig: Kopiere den Token sofort und bewahre ihn sicher auf. Er wird nur einmal vollständig angezeigt.
  4. Invite Code (Optional): Falls du eine App für andere Beds24-Nutzer entwickelst, arbeitest du mit Invite-Codes, aber für den Eigenbedarf reicht der Account Token.

Schritt 3: Die API-Dokumentation verstehen

Beds24 stellt eine interaktive Dokumentation (Swagger/OpenAPI) zur Verfügung. Das ist dein wichtigstes Werkzeug:

Schritt 4: Der erste Request (GET Properties)

Um zu testen, ob deine Verbindung steht, rufen wir die Liste deiner Unterkünfte (Properties) ab.

Tools: Du kannst Postman, Insomnia oder einfach curl im Terminal nutzen.

Request-Details:

  • Methode: GET
  • URL: https://api.beds24.com/v2/properties
  • Headers:
    • token: DEIN_ACCOUNT_TOKEN
    • accept: application/json

Beispiel in Python:

import requests

url = "https://api.beds24.com/v2/properties"
headers = {
    "token": "DEIN_API_TOKEN_HIER",
    "accept": "application/json"
}

response = requests.get(url, headers=headers)
print(response.json())

Schritt 5: Buchungen auslesen (GET Bookings)

Dies ist der am häufigsten genutzte Endpunkt. Du kannst verschiedene Filter anwenden.

  • URL: https://api.beds24.com/v2/bookings
  • Wichtige Parameter:
    • arrivalFrom: Startdatum (YYYY-MM-DD)
    • arrivalTo: Enddatum
    • includeInvoice: true (wenn du Rechnungsdaten brauchst)

Beispiel-URL mit Filtern: https://api.beds24.com/v2/bookings?arrivalFrom=2025-06-01&arrivalTo=2025-06-30

Schritt 6: Daten senden (POST / PUT)

Um Preise zu ändern oder Verfügbarkeiten zu setzen, nutzt du POST oder PUT.

Beispiel: Verfügbarkeit für ein Zimmer ändern

  • Endpoint: POST https://api.beds24.com/v2/inventory
  • Body (JSON):
    [
{
"roomId": 12345,
"startDate": "2025-07-01",
"endDate": "2025-07-05",
"numAvail": 1
}
]

Schritt 7: Best Practices & Fallstricke 2025

1. Rate Limiting (Begrenzungen)

Beds24 überwacht die Anzahl der Anfragen. Wenn du zu viele Requests in kurzer Zeit sendest, erhältst du einen 429 Too Many Requests Fehler.

  • Tipp: Nutze so oft wie möglich Batch-Requests (mehrere Änderungen in einem JSON-Array senden statt viele einzelne Requests).

2. Fehlerbehandlung

Achte auf die HTTP-Statuscodes:

  • 200 OK: Alles super.
  • 401 Unauthorized: Dein Token ist falsch oder abgelaufen.
  • 403 Forbidden: Dein Account/Sub-Account hat keine Rechte für diese Aktion.

3. Sicherheit

Gib deinen API-Token niemals in Client-seitigem JavaScript (Frontend) preis. Nutze immer ein Backend (Node.js, Python, PHP), das den API-Aufruf sicher ausführt und nur das Ergebnis an dein Frontend liefert.

4. Webhooks nutzen

Statt die API alle 5 Minuten zu fragen "Gibt es eine neue Buchung?" (Polling), solltest du Webhooks einrichten (Einstellungen > Account > Webhooks). Beds24 sendet dann automatisch eine Nachricht an deinen Server, sobald eine Buchung eingeht.

Fazit

Die Beds24 API V2 ist im Jahr 2025 der Standard für professionelle Integrationen. Dank der JSON-Struktur und der klaren Endpunkte ist sie deutlich einfacher zu handhaben als die alte XML-Schnittstelle.

Nächster Schritt: Lade dir Postman herunter, importiere die Endpunkte aus der Beds24 Swagger-Doku und starte mit deinem ersten GET-Request auf deine Properties!

0