API-Dokumentation Übersicht

Die meetergo Platform API ermöglicht die direkte Integration von Terminplanung in deine Anwendung. Erstelle Benutzer, verwalte Verfügbarkeiten, bearbeite Buchungen und verbinde Kalender, alles programmatisch.

Erste Schritte

1. API-Zugang erhalten

Die API-Plattform ist für berechtigte Tarife verfügbar. Kontaktiere den Support, um den API-Zugang für dein Konto zu aktivieren.

2. API-Schlüssel erstellen

1. Gehe zu Admin → API in deinem Dashboard
2. Klicke auf API-Schlüssel erstellen
3. Lege eine Ablaufzeit fest (1-90 Tage)
4. Kopiere und speichere deinen Schlüssel sicher

3. API-Schlüssel-Format

Dein API-Schlüssel folgt diesem Format:

ak_live:<uuid>:<secret>

Verwende die vollständige Zeichenkette als deinen Bearer-Token.

Authentifizierung

Alle API-Anfragen erfordern Authentifizierung per Bearer-Token:

curl -X GET "https://api.meetergo.com/v4/user/me" \
  -H "Authorization: Bearer ak_live:uuid:secret" \
  -H "x-meetergo-api-user-id: user-uuid"

Header

API-Referenz

Interaktive API-Dokumentation ist verfügbar unter:

https://api.meetergo.com/spec/v2

Diese Swagger UI ermöglicht es dir, Endpunkte zu erkunden, Anfrage-/Antwortschemas zu sehen und API-Aufrufe direkt zu testen.

Kern-Endpunkte

Benutzer

Verwalte Plattformbenutzer programmatisch.

Benutzer erstellen Beispiel

curl -X POST "https://api.meetergo.com/v4/user" \
  -H "Authorization: Bearer ak_live:uuid:secret" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "benutzer@beispiel.com",
    "firstname": "Max",
    "lastname": "Mustermann",
    "timezone": "Europe/Berlin"
  }'

Terminarten

Verwalte buchbare Terminarten.

Verfügbarkeit

Verfügbarkeit abfragen und verwalten.

Buchungen

Termine erstellen und verwalten.

Buchung erstellen Beispiel

curl -X POST "https://api.meetergo.com/v4/booking" \
  -H "Content-Type: application/json" \
  -d '{
    "meetingTypeId": "meeting-type-uuid",
    "start": "2025-01-15T10:00:00Z",
    "attendee": {
      "email": "teilnehmer@beispiel.com",
      "firstname": "Anna",
      "lastname": "Schmidt"
    }
  }'

Termin stornieren

Storniert einen Termin als Host oder Admin. Bei Gruppenterminen gibst du attendeeId an, um einen einzelnen Teilnehmer zu entfernen, oder setzt cancelAll: true, um den gesamten Termin zu stornieren.

curl -X POST "https://api.meetergo.com/v4/appointment/{id}/cancel" \
  -H "Authorization: Bearer ak_live:uuid:secret" \
  -H "x-meetergo-api-user-id: user-uuid" \
  -H "Content-Type: application/json" \
  -d '{
    "reason": "Terminkonflikt"
  }'

Termin verschieben

Verschiebt einen Termin auf ein neues Zeitfenster. Die Dauer bleibt unverändert. Erfordert das reschedule-Feature in deinem Tarif.

curl -X POST "https://api.meetergo.com/v4/appointment/{id}/reschedule" \
  -H "Authorization: Bearer ak_live:uuid:secret" \
  -H "x-meetergo-api-user-id: user-uuid" \
  -H "Content-Type: application/json" \
  -d '{
    "start": "2026-03-10T14:00:00.000Z"
  }'

Die Antwort enthält den aktualisierten Termin und die vorherige Startzeit:

{
  "appointment": { "id": "...", "start": "2026-03-10T14:00:00.000Z", "..." },
  "previousStart": "2026-03-08T10:00:00.000Z"
}

Kalenderverbindungen

Kalenderintegrationen verbinden und verwalten.

Webhooks

Erhalte Echtzeit-Benachrichtigungen bei Ereignissen. Siehe Webhooks-Dokumentation für Einrichtungsanweisungen.

Verfügbare Ereignisse

Webhook-Payload Beispiel

{
  "event": "booking_created",
  "timestamp": "2025-01-15T10:30:00Z",
  "data": {
    "appointmentId": "uuid",
    "meetingTypeId": "uuid",
    "start": "2025-01-15T10:00:00Z",
    "end": "2025-01-15T10:30:00Z",
    "attendee": {
      "email": "teilnehmer@beispiel.com",
      "firstname": "Anna",
      "lastname": "Schmidt"
    }
  }
}

Nutzungsbasierte Abrechnung

Die API-Plattformnutzung wird gemessen. Jede über die API erstellte Buchung zählt zu deiner Nutzung. Überwache deine Nutzung im Dashboard unter Abrechnung.

Rate Limits

Um Plattformstabilität zu gewährleisten:

• Standardrate: 100 Anfragen pro Minute pro API-Schlüssel
• Burst-Erlaubnis: Kurze Bursts bis zu 200 Anfragen

Bei Ratenbegrenzung erhältst du eine 429 Too Many Requests-Antwort. Implementiere exponentielles Backoff für Wiederholungen.

Fehlerbehandlung

Die API gibt Standard-HTTP-Statuscodes zurück:

Fehlerantwort-Format

{
  "statusCode": 400,
  "message": "Validierung fehlgeschlagen",
  "errors": [
    {
      "field": "email",
      "message": "Ungültiges E-Mail-Format"
    }
  ]
}

Best Practices

API-Schlüssel sichern

• Schlüssel niemals in clientseitigem Code exponieren
• Umgebungsvariablen verwenden
• Schlüssel regelmäßig rotieren
• Minimale erforderliche Berechtigungen verwenden

Fehler elegant behandeln

• Wiederholungslogik mit exponentiellem Backoff implementieren
• Fehler für Debugging protokollieren
• Aussagekräftige Fehlermeldungen an Benutzer liefern

Performance optimieren

• Antworten bei Bedarf cachen
• Paginierung für große Datensätze verwenden
• Operationen wenn möglich bündeln

SDKs und Bibliotheken

Obwohl wir noch keine offiziellen SDKs anbieten, kann die OpenAPI-Spezifikation unter /spec/v2 Client-Bibliotheken für die meisten Sprachen generieren mit Tools wie:

• OpenAPI Generator
• Swagger Codegen

Support

Für API-bezogene Fragen:

• Prüfe die interaktive Dokumentation unter /spec/v2
• Kontaktiere den Support per Chat
• E-Mail an api-support@meetergo.com

Verwandte Artikel

• Webhooks in meetergo
• HubSpot verbinden