New: an AI assistant that answers with your gym's real numbers. See how it works
Ne işletiyorsunuz?Muay ThaiYogaCrossFitPilatesBoxingSwimmingDersler, üyeler, fiyatlar ve şunun için belirlenen sözcükler: Muay ThaiKendi faaliyetinizle deneyinDemo; dersleri, üyeleri, fiyatları ve kelimeleri işletmenize uyacak şekilde değiştirir.Faaliyetinizi seçin

API v1 · OpenID Connect

Sitenizi spor salonunuza bağlayın.

Üyeler spor salonu hesaplarıyla giriş yapsın, üyeliklerini sorgulasın, ders rezervasyonu yapsın ve programınız kendi sitenizde görünsün. Standart OpenID Connect, küçük bir REST API ve imzalı webhook'lar.

  • OpenID Connect
  • PKCE zorunlu
  • İmzalı webhook'lar

API Şartlarını oku

01 · Hızlı başlangıç

MoveMembers API hızlı başlangıç: giriş, takas, okuma.

Üyeler spor salonu hesaplarıyla giriş yapar. Siteniz, üye numarasını içeren imzalı bir yanıt alır, bu yüzden her OIDC kütüphanesi çalışır.

01

Düğmeyi ekleyin

Üyeyi kendi salonunun giriş sayfasına gönderin. PKCE, gizli ya da herkese açık, her uygulama için zorunludur.

Authorize requestHTML
<!-- "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

Kodu sunucunuzda takas edin

Spor salonunun imzaladığı bir ID token alırsınız (ES256, anahtarlar /oauth/jwks adresinde). Bu takası asla bir sayfadan yapmayın: istemci sırrınızı gerektirir.

Kod örneğiNode.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

Claim'leri okuyun

Yalnızca spor salonunun doğruladığı ve üyenin onayladığı bilgiler. Kaydınızı e-posta adresine değil, "sub" alanına bağlayın.

ID token claim'leriJSON
{
  "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 · Üye sorgulama

Üye numarasını ve e-postayı birlikte sorgulayın.

Sunucudan sunucuya, bir uygulama jetonuyla (client_credentials, scope=lookup). Bunları gövdede gönderin, asla adreste değil: adresler sunucu günlüklerine düşer.

Yanıt her zaman 200 ve tek bir alan olan "active" ile gelir, böylece kimse formunuzu kullanarak kimin üye olduğunu öğrenemez. Yalnızca hatalı biçimli bir gövde 400 invalid_request yanıtı alır.

Tarifler

Spor salonu API'si için tarifler.

Yazma yapan her uç nokta, spor salonunun kendi uygulamalarıyla tamamen aynı kuralları çalıştırır: rezervasyon pencereleri, bekleme listeleri, paket kontrolleri.

Bir kaydı bağlayın

Sitenizdeki bir kaydı bir üyeye bağlayın

Bir köpek, bir dolap, bir araba: "sub" değerini kendi kaydınızda yabancı anahtar olarak saklayın, e-postayı asla. Durumu sonra bir uygulama token'ıyla yeniden sorgulayın.

Kılavuza bakın

Ders rezerve et

Üye adına rezervasyon yapın veya iptal edin

Programı listeleyin, ardından üyenin erişim token'ıyla rezervasyon yapın. "booking_refused" yanıtı her zaman üyenin anlayacağı bir neden taşır: error.message değerini gösterin.

Kılavuza bakın

Program ve fiyatlar

Programınızı ve fiyatlarınızı gösterin

Herkese açık bilgi, üyenin oturum açması gerekmez. scope=schedule içeren tek bir uygulama jetonu /schedule ve /offers uç noktalarını okur.

Kılavuza bakın

Doğrulayın, sonra bir grup atayın

Kimliği üçüncü bir tarafla doğrulayın, ardından bir grup atayın

Sağlayıcı sonucu sunucunuza iletir, asla bir tarayıcı sayfasına değil. Yalnızca üyenin hak ettiği grubu gönderin, kimlik verisi göndermeyin.

Kılavuza bakın

05 · Webhook'lar

İmzalı webhook'lar, birkaç satırda doğrulanır.

member.connected, member.disconnected, member.status_changed, booking.created, booking.cancelled, payment.completed, member.group_changed. 2xx yanıtı alınmazsa yaklaşık 3 saat içinde en fazla 5 kez yeniden denenir.

HAM gövde üzerinden doğrulayın, 5 dakikadan eski imzalı her şeyi reddedin, ardından X-Webhook-Id ile tekrarları ayıklayın. İmza sırrı yalnızca bir kez, uygulamanın Webhook'lar sekmesinde gösterilir.

10 · Başvuru

Tüm MoveMembers API uç noktaları.

Her yerde JSON. Siteniz üzerinden geldiği için hiçbir şey farklı davranmaz.

YöntemYolNe yaparKimlik doğrulama
GET/.well-known/openid-configurationKeşif belgesinone
GET/oauth/jwksHerkese açık imzalama anahtarlarınone
GET/oauth/authorizeGiriş ya da kayıt başlatınnone
POST/oauth/tokenBir kodu değiştirin, yenileyin ya da bir uygulama belirteci alınuygulama kimlik bilgileri
GET/oauth/userinfoGiriş yapmış üyenin taleplerimember, Bearer
POST/oauth/revokeBir belirteci iptal edinuygulama kimlik bilgileri
GET/api/v1/meGiriş yapmış üyemember, Bearer
GET/api/v1/me/bookingsRezervasyonları ve paketleri (kalan dersler, tarihler, ödenecek tutar)member, Bearer
POST/api/v1/bookingsOnun adına bir ders rezerve edinmember, Bearer
DELETE/api/v1/bookings/{id}Bir rezervasyonu iptal edinmember, Bearer
GET/api/v1/members/{member_number}Üyeyi numarayla sorgulayınuygulama, scope=lookup
POST/api/v1/members/verifyBir üye numarasını ve bir e-postayı birlikte doğrulayınuygulama, scope=lookup
GET/api/v1/scheduleHerkese açık ders programıuygulama, scope=schedule
GET/api/v1/offersHerkese açık satıştaki paketler ve ürünleruygulama, scope=schedule
GET/api/v1/groupsBu uygulamanın ayarlayabileceği gruplaruygulama, scope=groups
PUT/api/v1/members/{member_number}/groupBir üyenin grubunu ayarlayın (ya da temizleyin)uygulama, scope=groups

Yalnızca GET /members/{member_number} ve POST /members/verify üyenin onayı olmadan çalışır ve üyeliğin etkin olup olmadığından başka hiçbir şey döndürmez.

12 · Hız sınırları

Hız sınırları, dakika başına sayılır.

Sınır aşıldığında API, Retry-After başlığıyla 429 rate_limited yanıtı verir. Her sınıfın kendi kotası vardır, bu yüzden yoğun okuma rezervasyon kotanızı hiç tüketmez.

300uygulama başına okuma çağrısı / dk/me, /me/bookings, /schedule, /offers, /groups
120uygulama başına yazma çağrısı / dkrezervasyonlar ve gruplar
120uygulama başına üye sorgusu / dklookup ve verify için ortak tek bir kota
600/api/v1 üzerinde dakikada çağrıaynı salonun tüm uygulamaları arasında paylaşılır

11 · Hatalar

Hatalar, her yerde tek biçim.

Her /api/v1 hatası { "error": { "code", "message", "request_id" } } biçimindedir. /oauth uç noktaları standart OAuth biçimini korur, bu yüzden OAuth kütüphaneleri olduğu gibi çalışır.

KodAnlamı
invalid_requestİstek hatalı biçimli: bilinmeyen veya yanlış yazılmış bir alan, eksik bir parametre ya da fazla büyük bir gövde.
invalid_tokenBearer belirteci eksik, süresi dolmuş ya da iptal edilmiş.
insufficient_scopeBelirteç, bu uç noktanın ihtiyaç duyduğu kapsamı taşımıyor.
capability_offSalon bu özelliği uygulamanız için etkinleştirmemiş.
plan_requiredSalonun paketi şu anda bağlı uygulamaları içermiyor. Hiçbir şey silinmez; yükselttikleri anda geri gelir.
bu kişiyle açık bir konuşma yokBu kaynak mevcut değil (ya da bu salona ait değil).
rate_limitedÇok fazla istek. Retry-After başlığındaki saniye kadar bekleyin, sonra yeniden deneyin.
booking_refusedRezervasyon kuralları bu isteği reddetti; message nedenini açıklar. membership_ ile başlayan bir mesaj, hiçbir rezervasyon oluşturulmadığı anlamına gelir.
noshow_blockedBir booking_refused mesajı: üye, salonun gelmeme sınırına ulaştı ve şimdilik çevrimiçi rezervasyon yapamıyor. Hata count, threshold ve windowDays değerlerini taşır.
age_restrictedBir booking_refused mesajı: üye, dersin en düşük yaş sınırının altında. Hata ageMin değerini taşır.
guardian_requiredBir booking_refused mesajı: üye reşit değil ve salon, kartında bir velinin adını ve telefonunu istiyor.
guardian_consent_requiredBir booking_refused mesajı: üye reşit değil ve salon, henüz kaydedilmemiş veli onayını istiyor.
payment_requiredBu rezervasyonun önce ödenmesi gerekir. Hata, üyenin ödeme sayfası olan payment_address değerini taşır.
no_consentBu üye henüz uygulamanıza bağlanmadı.
group_not_allowedBu grup, salonun uygulamanız için etkinleştirdiği gruplardan biri değil.

request_id aynı zamanda X-Request-Id başlığı olarak da gönderilir: yardım isterken belirtin, çağrınızı günlükte bulur.

Sorular

MoveMembers API hakkında sorular.

MoveMembers API hangi giriş standardını kullanıyor?
PKCE'li standart OpenID Connect; gizli ya da genel her uygulama için zorunludur. Sertifikalı her OIDC istemci kütüphanesi çalışır, keşif belgesi /.well-known/openid-configuration adresindedir.
Üyeler her seferinde bir onay ekranı görecek mi?
Hayır. Üyeler o cihazda salonda oturum açık olduğu sürece oturum açma ekranı atlanır ve onay, üye ve uygulama başına bir kez gösterilir. Gerçekten gerekmedikçe prompt=login, prompt=consent ve max_age kullanmaktan kaçının.
Kayıtlarımı e-postaya mı yoksa sub'a mı bağlamalıyım?
"sub" alanına. Bu üye ve bu uygulama için asla değişmez, üye e-postasını değiştirse bile. "email_verified": false değerini doğrulanmamış sayın.
Üye numarası ve e-posta kimliği kanıtlamaya yeter mi?
Hayır. Birinin bu bilgileri bildiğini gösterir, o kişinin üye olduğunu değil. Hesap sahibinden emin olmak için giriş düğmesini kullanın ve "sub" değerini okuyun.
Bir üyenin ders için paketi yoksa ne olur?
Rezervasyon, membership_ ile başlayan bir mesajla booking_refused yanıtı verir ve rezervasyon oluşmaz. GET /me/bookings çağrısını okuyun ve üyeyi paket almaya yönlendirin.
Hangi webhook olayları var?
member.connected, member.disconnected, member.status_changed, booking.created, booking.cancelled, payment.completed ve member.group_changed, imzalı POST istekleri olarak iletilir.
API'yi yerelde nasıl test ederim?
http://localhost adresini (herhangi bir port) dönüş adresi olarak kaydedin: düz http üzerinden kabul edilen tek adrestir. Yayına geçmeden önce gerçek canlı adresinizi ekleyin.

Salonunuzun üzerine inşa edin. Kendi hesabınızla başlayın.

Stüdyonuzu oluşturun, bir uygulama ve bir localhost dönüş adresi kaydedin, tüm akışı test edin.

  • 14 gün boyunca Max ücretsiz
  • Kredi kartı gerekmez
  • Satış görüşmesi yok