Kunden-Workspaces mit der Partner-API anlegen

Mit der Partner-API legst du Kunden-Workspaces aus deinem eigenen System an, zum Beispiel wenn eine Bestellung bezahlt ist. Jeder Aufruf folgt denselben Regeln wie Kunden hinzufügen im Partnerportal.

Bevor du startest

Deine Partnerfirma hat freigegebene kommerzielle Konditionen, und du hast die aktuellen Partnerbedingungen akzeptiert.
Du bist Admin deiner Partnerfirma.
Für Partner zahlt meetergo ist die Partner-Abrechnung eingerichtet. Siehe Kunden-Workspace anlegen und einrichten.

API-Schlüssel erstellen

Öffne Partnerportal > API.
Wähle API-Schlüssel erstellen und gib dem Schlüssel einen Namen, zum Beispiel „Produktion“.
Kopiere den Schlüssel. Er beginnt mit mgp_ und wird nur einmal angezeigt.

Speichere den Schlüssel als Secret auf deinem Server. Nutze ihn nie in einer Website oder App: Wer den Schlüssel hat, kann Workspaces anlegen, die dir berechnet werden.

Der Schlüssel handelt mit deinen Admin-Rechten. Er funktioniert nicht mehr, wenn du ihn widerrufst oder wenn die Person, die ihn erstellt hat, kein Admin deiner Partnerfirma mehr ist. Du kannst zwei aktive Schlüssel haben. So wechselst du zu einem neuen Schlüssel, bevor du den alten widerrufst.

Authentifizierung

Sende den Schlüssel bei jeder Anfrage als Bearer-Token:

Authorization: Bearer mgp_...

Basis-URL: https://api.meetergo.com

Kunden anlegen

POST /v4/partner/customers

curl -X POST https://api.meetergo.com/v4/partner/customers \
  -H "Authorization: Bearer $MEETERGO_PARTNER_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "requestId": "6f1c2a8e-3b4d-4e5f-8a9b-0c1d2e3f4a5b",
    "companyName": "Friseur Muster",
    "adminFirstName": "Max",
    "adminLastName": "Muster",
    "adminEmail": "max@friseur-muster.de",
    "language": "de",
    "timezone": "Europe/Berlin",
    "billingResponsibility": "partner",
    "suiteTier": "suite",
    "communicationOwner": "partner",
    "contactConsentConfirmed": true
  }'

Feld	Pflicht	Bedeutung
`requestId`	Ja	Eine UUID, die du einmal pro Bestellung erzeugst. Macht Wiederholungen sicher.
`companyName`	Ja	Name der Firma deines Kunden.
`adminFirstName`, `adminLastName`	Ja	Name des ersten Admins beim Kunden.
`adminEmail`	Ja	Bekommt die Einladung. Darf noch kein meetergo-Konto haben.
`language`	Ja	Sprache für E-Mails und die Buchungsseite, zum Beispiel `de`.
`timezone`	Ja	Zum Beispiel `Europe/Berlin`.
`billingResponsibility`	Ja	`partner`: auf deiner monatlichen Partnerrechnung. `customer`: der Kunde zahlt meetergo selbst.
`suiteTier`	Bei `partner`	`light`, `suite` oder `premium`.
`communicationOwner`	Ja	`partner` oder `meetergo`: wer den Kunden zu seinem Konto kontaktiert.
`contactConsentConfirmed`	Ja	Muss `true` sein. Bestätigt, dass der Kunde der Einrichtung und dem Kontakt zugestimmt hat.
`partnerRetailPricePerSeatEur`	Nein	Dein eigener Preis pro Platz, nur für deine Übersicht, zum Beispiel `"19.00"`.
`extraEmails`	Nein	Weitere Teammitglieder zum Einladen, bis zu 100.

Die Antwort enthält den neuen customer mit companyId und bookingPageUrl. Der Admin deines Kunden bekommt eine Einladung per E-Mail und legt sein Passwort selbst fest. Die Buchungsseite nimmt sofort Buchungen an, auch vor der Annahme der Einladung.

Erzeuge die requestId einmal pro Bestellung und speichere sie. Läuft eine Anfrage in einen Timeout, sende sie mit derselben requestId erneut. Du bekommst dann den bestehenden Kunden zurück statt eines zweiten Workspaces.

Kunden auflisten und abrufen

curl "https://api.meetergo.com/v4/partner/customers?limit=50&offset=0" \
  -H "Authorization: Bearer $MEETERGO_PARTNER_KEY"

curl https://api.meetergo.com/v4/partner/customers/{companyId} \
  -H "Authorization: Bearer $MEETERGO_PARTNER_KEY"

Die Liste liefert deine aktiven Kunden, die neuesten zuerst. limit liegt zwischen 1 und 100. hasMore zeigt, ob es eine weitere Seite gibt.

Buchungsseite einbetten

Füge die zurückgegebene bookingPageUrl in die Website deines Kunden ein:

<div style="min-width:330px" class="meetergo-iframe" data-src="{bookingPageUrl}"></div>
<script src="https://cdn.meetergo.com/v4/integration.js"></script>

Fehler

Fehler kommen als JSON mit statusCode und message.

Status	Bedeutung
400	Der Body ist ungültig. `message` nennt jedes Feld und das Problem.
401	Der Schlüssel fehlt, ist falsch oder widerrufen, oder die Person, die ihn erstellt hat, ist kein Admin mehr.
403	Dein Partnerzugang ist inaktiv, oder die aktuellen Partnerbedingungen sind noch nicht akzeptiert.
404	Kein aktiver Kunde mit dieser `companyId` gehört zu dir.
409	Die E-Mail hat schon ein Konto, die `requestId` wurde mit anderen Daten genutzt, oder die Partner-Abrechnung ist nicht eingerichtet.
429	Zu viele Anfragen. Warte kurz und wiederhole die Anfrage mit derselben `requestId`.

Schlüssel widerrufen

Öffne Partnerportal > API und wähle Widerrufen neben dem Schlüssel. Anfragen damit schlagen sofort fehl. Bereits angelegte Kunden sind nicht betroffen.

Passende Artikel