API-Dokumentation Übersicht

Die meetergo Platform API ermöglicht die direkte Integration von Terminplanung in Ihre Anwendung. Erstellen Sie Benutzer, verwalten Sie Verfügbarkeiten, bearbeiten Sie Buchungen und verbinden Sie Kalender – alles programmatisch.

Erste Schritte

1. API-Zugang erhalten

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

2. API-Schlüssel erstellen

1. Gehen Sie zu Einstellungen → API-Schlüssel in Ihrem Dashboard
2. Klicken Sie auf API-Schlüssel erstellen
3. Legen Sie eine Ablaufzeit fest (1-90 Tage)
4. Kopieren und speichern Sie Ihren Schlüssel sicher

3. API-Schlüssel-Format

Ihr API-Schlüssel folgt diesem Format:

ak_live:<uuid>:<secret>

Verwenden Sie die vollständige Zeichenkette als Ihren 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 Ihnen, Endpunkte zu erkunden, Anfrage-/Antwortschemas zu sehen und API-Aufrufe direkt zu testen.

Kern-Endpunkte

Benutzer

Verwalten Sie 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

Verwalten Sie 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"
    }
  }'

Kalenderverbindungen

Kalenderintegrationen verbinden und verwalten.

Webhooks

Erhalten Sie 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 Ihrer Nutzung. Überwachen Sie Ihre 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 erhalten Sie eine 429 Too Many Requests-Antwort. Implementieren Sie 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üfen Sie die interaktive Dokumentation unter /spec/v2
• Kontaktieren Sie den Support per Chat
• E-Mail an api-support@meetergo.com

Verwandte Artikel

• Webhooks in meetergo
• HubSpot verbinden