Neu: ein KI-Assistent, der mit den echten Zahlen Ihres Studios antwortet. Mehr erfahren
Was betreiben Sie?Muay ThaiYogaCrossFitPilatesBoxingSwimmingKurse, Mitglieder, Preise und Texte, eingestellt für Muay ThaiProbieren Sie es mit Ihrer TätigkeitDie Demo passt Kurse, Mitglieder, Preise und Begriffe an Ihr Geschäft an.Meine Tätigkeit wählen

API v1 · OpenID Connect

Verbinden Sie Ihre Website mit Ihrem Studio.

Lassen Sie Mitglieder sich mit ihrem Studiokonto anmelden, Mitgliedschaften prüfen, Kurse buchen und Ihren Stundenplan auf Ihrer eigenen Website anzeigen. Standard-OpenID-Connect, eine schlanke REST-API und signierte Webhooks.

  • OpenID Connect
  • PKCE erforderlich
  • Signierte Webhooks

API-Bedingungen lesen

01 · Schnellstart

Schnellstart zur MoveMembers API: anmelden, tauschen, lesen.

Mitglieder melden sich mit ihrem Studiokonto an. Ihre Website erhält eine signierte Antwort mit der Mitgliedsnummer, daher funktioniert jede OIDC-Bibliothek.

01

Button hinzufügen

Leiten Sie das Mitglied zur Anmeldeseite seines Studios weiter. PKCE ist für jede App Pflicht, ob vertraulich oder öffentlich.

AutorisierungsanfrageHTML
<!-- "Join Your Gym" -->
<a href="https://movemembers.com/oauth/authorize?client_id=app_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx&response_type=code&scope=openid%20member_number%20profile%20email%20phone%20membership%20bookings%20field%3Avisitor_type&redirect_uri=https://yoursite.com/callback&state=…&nonce=…&code_challenge=…&code_challenge_method=S256&prompt=create"
  style="display:inline-flex;align-items:center;gap:10px;padding:12px 20px;
  border-radius:10px;background:#ffffff;color:#14161b;border:1px solid #e4e6ef;
  font-family:inherit;
  font-size:15px;font-weight:600;text-decoration:none">
  Join Your Gym
</a>
02

Den Code auf Ihrem Server einlösen

Sie erhalten ein vom Studio signiertes ID-Token (ES256, Schlüssel unter /oauth/jwks). Führen Sie diesen Austausch nie aus einer Seite heraus durch: Er benötigt Ihr Client-Secret.

CodebeispielNode.js
const { Issuer } = require("openid-client"); // any certified OIDC client works

const issuer = await Issuer.discover("https://movemembers.com");
const client = new issuer.Client({
  client_id: "app_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  client_secret: process.env.APP_SECRET, // never hard-code this
  redirect_uris: ["https://yoursite.com/callback"],
  response_types: ["code"],
});

// codeVerifier is the one you generated before redirecting the member
const tokenSet = await client.callback(
  "https://yoursite.com/callback",
  params, // req.query, from the redirect
  { code_verifier: codeVerifier, state, nonce },
);
// tokenSet.claims() is verified against the gym's public keys at /oauth/jwks
const member = tokenSet.claims();
03

Die Claims auslesen

Nur das, was das Studio geprüft und das Mitglied freigegeben hat. Verknüpfen Sie Ihren Datensatz mit "sub", nie mit der E-Mail-Adresse.

Claims des ID-TokensJSON
{
  "sub": "mbr_4Hq9kR2vLpXsT8nZ",
  "member_number": "1042",
  "name": "Nok Suwan",
  "email": "nok@example.com",
  "email_verified": true,
  "phone_number": "+66812345678",
  "membership": { "status": "active", "plan": "Monthly", "ends": "2026-11-01" },
  "fields": { "visitor_type": "…" }
}

04 · Mitglied prüfen

Prüfen Sie Mitgliedsnummer und E-Mail gemeinsam.

Server zu Server, mit einem App-Token (client_credentials, scope=lookup). Senden Sie sie im Body, nie in der Adresse: Eine Adresse landet in Server-Logs.

Die Antwort ist immer 200 mit einem einzigen Feld, "active". So kann niemand mit Ihrem Formular herausfinden, wer Mitglied ist. Nur ein fehlerhafter Body ergibt 400 invalid_request.

Rezepte

Rezepte für die Studio-API.

Jeder Schreibzugriff nutzt exakt dieselben Regeln wie die eigenen Apps des Studios: Buchungsfenster, Wartelisten, Tarifprüfungen.

Datensatz verknüpfen

Einen Datensatz Ihrer Website mit einem Mitglied verknüpfen

Ein Hund, ein Spind, ein Auto: Speichern Sie "sub" in Ihrem eigenen Datensatz als Fremdschlüssel, nie die E-Mail. Prüfen Sie den Status später erneut mit einem App-Token.

Zum Handbuch

Kurs buchen

Im Namen des Mitglieds buchen oder stornieren

Rufen Sie den Stundenplan ab und buchen Sie dann mit dem Zugriffstoken des Mitglieds. Ein "booking_refused" enthält immer einen Grund, den das Mitglied nachvollziehen kann: Zeigen Sie error.message an.

Zum Handbuch

Stundenplan und Preise

Stundenplan und Preise anzeigen

Öffentliche Informationen, keine Anmeldung des Mitglieds nötig. Ein App-Token mit scope=schedule liest /schedule und /offers.

Zum Handbuch

Prüfen, dann eine Gruppe zuweisen

Die Identität über einen Dritten prüfen, dann eine Gruppe setzen

Der Anbieter ruft Ihren Server mit dem Ergebnis auf, nie eine Browserseite. Senden Sie nur die Gruppe, die das Mitglied erreicht hat, nie Identitätsdaten.

Zum Handbuch

05 · Webhooks

Signierte Webhooks, in wenigen Zeilen geprüft.

member.connected, member.disconnected, member.status_changed, booking.created, booking.cancelled, payment.completed, member.group_changed. Ohne 2xx-Antwort bis zu 5 Wiederholungen über etwa 3 Stunden.

Prüfen Sie auf dem RAW-Body, lehnen Sie alles ab, was vor mehr als 5 Minuten signiert wurde, und entdoppeln Sie dann über X-Webhook-Id. Das Signatur-Secret wird einmal angezeigt, im Tab Webhooks der App.

10 · Referenz

Alle API-Endpunkte von MoveMembers.

Überall JSON. Nichts verhält sich anders, nur weil der Aufruf von Ihrer Website kommt.

ZahlungsartPfadWas sie tutAuthentifizierung
GET/.well-known/openid-configurationDiscovery-Dokumentnone
GET/oauth/jwksÖffentliche Signaturschlüsselnone
GET/oauth/authorizeEine Anmeldung oder Registrierung startennone
POST/oauth/tokenEinen Code eintauschen, aktualisieren oder ein App-Token abrufenApp-Zugangsdaten
GET/oauth/userinfoDie Claims des angemeldeten Mitgliedsmember, Bearer
POST/oauth/revokeEin Token widerrufenApp-Zugangsdaten
GET/api/v1/meDas angemeldete Mitgliedmember, Bearer
GET/api/v1/me/bookingsSeine Buchungen und seine Tarife (verbleibende Kurse, Daten, offener Betrag)member, Bearer
POST/api/v1/bookingsIm Namen des Mitglieds einen Kurs buchenmember, Bearer
DELETE/api/v1/bookings/{id}Eine Buchung stornierenmember, Bearer
GET/api/v1/members/{member_number}Ein Mitglied anhand der Nummer prüfenApp, scope=lookup
POST/api/v1/members/verifyMitgliedsnummer und E-Mail gemeinsam prüfenApp, scope=lookup
GET/api/v1/scheduleÖffentlicher KursplanApp, scope=schedule
GET/api/v1/offersÖffentlich verkaufte Tarife und ProdukteApp, scope=schedule
GET/api/v1/groupsGruppen, die diese App setzen kannApp, scope=groups
PUT/api/v1/members/{member_number}/groupDie Gruppe eines Mitglieds setzen (oder löschen)App, scope=groups

Nur GET /members/{member_number} und POST /members/verify funktionieren ohne Einwilligung des Mitglieds, und sie liefern nur zurück, ob die Mitgliedschaft aktiv ist.

12 · Ratenlimits

Ratenlimits, pro Minute gezählt.

Bei Überschreitung antwortet die API mit 429 rate_limited und einem Retry-After-Header. Jede Klasse hat ihr eigenes Kontingent, sodass intensives Lesen nie Ihre Buchungen aufbraucht.

300Lesezugriffe pro App / Min./me, /me/bookings, /schedule, /offers, /groups
120Schreibzugriffe pro App / Min.Buchungen und Gruppen
120Mitgliederprüfungen pro App / Min.ein gemeinsames Kontingent für Abfrage und Prüfung
600Aufrufe pro Minute auf /api/v1von allen Apps eines Studios gemeinsam genutzt

11 · Fehler

Fehler, überall im selben Format.

Jeder /api/v1-Fehler sieht so aus: { "error": { "code", "message", "request_id" } }. Die /oauth-Endpunkte behalten das Standardformat von OAuth, daher funktionieren OAuth-Bibliotheken unverändert.

CodeBedeutung
invalid_requestDie Anfrage ist fehlerhaft: ein unbekanntes oder falsch geschriebenes Feld, ein fehlender Parameter, ein zu großer Body.
invalid_tokenDas Bearer-Token fehlt, ist abgelaufen oder wurde widerrufen.
insufficient_scopeDas Token enthält nicht den Scope, den dieser Endpunkt benötigt.
capability_offDas Studio hat diese Funktion für Ihre App nicht aktiviert.
plan_requiredDer Tarif des Studios enthält derzeit keine verbundenen Apps. Nichts wird gelöscht; sie sind sofort wieder da, sobald es upgradet.
keine offene Unterhaltung mit dieser PersonDiese Ressource existiert nicht (oder gehört nicht zu diesem Studio).
rate_limitedZu viele Anfragen. Warten Sie die im Retry-After-Header genannten Sekunden ab und versuchen Sie es dann erneut.
booking_refusedDie Buchungsregeln haben diese Anfrage abgelehnt; message nennt den Grund. Beginnt eine Meldung mit membership_, wurde keine Buchung angelegt.
noshow_blockedEine booking_refused-Meldung: Das Mitglied hat das Limit des Studios für Nichterscheinen erreicht und kann vorerst nicht online buchen. Der Fehler enthält count, threshold und windowDays.
age_restrictedEine booking_refused-Meldung: Das Mitglied hat das Mindestalter des Kurses nicht erreicht. Der Fehler enthält ageMin.
guardian_requiredEine booking_refused-Meldung: Das Mitglied ist minderjährig, und das Studio benötigt Name und Telefonnummer einer erziehungsberechtigten Person in der Akte.
guardian_consent_requiredEine booking_refused-Meldung: Das Mitglied ist minderjährig, und das Studio benötigt die noch nicht erfasste Einwilligung der erziehungsberechtigten Person.
payment_requiredDiese Buchung muss zuerst bezahlt werden. Der Fehler enthält payment_address, die Zahlungsseite des Mitglieds.
no_consentDieses Mitglied hat sich noch nicht mit Ihrer App verbunden.
group_not_allowedDiese Gruppe wurde vom Studio für Ihre App nicht freigegeben.

request_id wird auch als X-Request-Id-Header gesendet: Nennen Sie ihn bei Supportanfragen, damit finden wir Ihren Aufruf im Log.

Fragen

Fragen zur MoveMembers-API.

Welchen Anmeldestandard nutzt die MoveMembers API?
Standard-OpenID-Connect mit PKCE, für jede App erforderlich, ob vertraulich oder öffentlich. Jede zertifizierte OIDC-Client-Bibliothek funktioniert, das Discovery-Dokument liegt unter /.well-known/openid-configuration.
Sehen Mitglieder jedes Mal einen Zustimmungsbildschirm?
Nein. Der Anmeldebildschirm entfällt, solange die Person auf diesem Gerät noch im Studio angemeldet ist, und die Freigabe wird einmal pro Mitglied und App abgefragt. Vermeiden Sie prompt=login, prompt=consent und max_age, es sei denn, Sie brauchen sie wirklich.
Soll ich meine Datensätze mit der E-Mail oder mit sub verknüpfen?
Mit "sub". Dieser Wert ändert sich für dieses Mitglied und diese App nie, auch wenn die E-Mail wechselt. Behandeln Sie "email_verified": false als nicht verifiziert.
Reichen Mitgliedsnummer und E-Mail als Identitätsnachweis?
Nein. Das belegt nur, dass jemand diese Angaben kennt, nicht dass er das Mitglied ist. Um sicher zu sein, dass es der Kontoinhaber ist, nutzen Sie den Anmelde-Button und lesen Sie dessen "sub".
Was passiert, wenn ein Mitglied keinen passenden Tarif für einen Kurs hat?
Die Buchung antwortet mit booking_refused und einer Meldung, die mit membership_ beginnt, und es wird keine Buchung angelegt. Lesen Sie GET /me/bookings und schicken Sie das Mitglied zum Kauf eines Tarifs.
Welche Webhook-Ereignisse gibt es?
member.connected, member.disconnected, member.status_changed, booking.created, booking.cancelled, payment.completed und member.group_changed, zugestellt als signierte POSTs.
Wie teste ich die API lokal?
Tragen Sie http://localhost (beliebiger Port) als Rücksprungadresse ein: Es ist die einzige Adresse, die über reines http akzeptiert wird. Fügen Sie vor dem Livegang Ihre echte Produktivadresse hinzu.

Bauen Sie auf Ihrem Studio auf. Starten Sie mit Ihrem eigenen Konto.

Legen Sie Ihr Studio an, registrieren Sie eine App und eine localhost-Rücksprungadresse und testen Sie den gesamten Ablauf.

  • 14 Tage Max kostenlos
  • Ohne Kreditkarte
  • Kein Verkaufsgespräch