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
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.
Düğmeyi ekleyin
Üyeyi kendi salonunun giriş sayfasına gönderin. PKCE, gizli ya da herkese açık, her uygulama için zorunludur.
<!-- "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>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.
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();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.
{
"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ınDers 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ınProgram 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ınDoğ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ın05 · 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öntem | Yol | Ne yapar | Kimlik doğrulama |
|---|---|---|---|
| GET | /.well-known/openid-configuration | Keşif belgesi | none |
| GET | /oauth/jwks | Herkese açık imzalama anahtarları | none |
| GET | /oauth/authorize | Giriş ya da kayıt başlatın | none |
| POST | /oauth/token | Bir kodu değiştirin, yenileyin ya da bir uygulama belirteci alın | uygulama kimlik bilgileri |
| GET | /oauth/userinfo | Giriş yapmış üyenin talepleri | member, Bearer |
| POST | /oauth/revoke | Bir belirteci iptal edin | uygulama kimlik bilgileri |
| GET | /api/v1/me | Giriş yapmış üye | member, Bearer |
| GET | /api/v1/me/bookings | Rezervasyonları ve paketleri (kalan dersler, tarihler, ödenecek tutar) | member, Bearer |
| POST | /api/v1/bookings | Onun adına bir ders rezerve edin | member, Bearer |
| DELETE | /api/v1/bookings/{id} | Bir rezervasyonu iptal edin | member, Bearer |
| GET | /api/v1/members/{member_number} | Üyeyi numarayla sorgulayın | uygulama, scope=lookup |
| POST | /api/v1/members/verify | Bir üye numarasını ve bir e-postayı birlikte doğrulayın | uygulama, scope=lookup |
| GET | /api/v1/schedule | Herkese açık ders programı | uygulama, scope=schedule |
| GET | /api/v1/offers | Herkese açık satıştaki paketler ve ürünler | uygulama, scope=schedule |
| GET | /api/v1/groups | Bu uygulamanın ayarlayabileceği gruplar | uygulama, scope=groups |
| PUT | /api/v1/members/{member_number}/group | Bir ü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.
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.
| Kod | Anlamı |
|---|---|
| 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_token | Bearer belirteci eksik, süresi dolmuş ya da iptal edilmiş. |
| insufficient_scope | Belirteç, bu uç noktanın ihtiyaç duyduğu kapsamı taşımıyor. |
| capability_off | Salon bu özelliği uygulamanız için etkinleştirmemiş. |
| plan_required | Salonun 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 yok | Bu 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_refused | Rezervasyon kuralları bu isteği reddetti; message nedenini açıklar. membership_ ile başlayan bir mesaj, hiçbir rezervasyon oluşturulmadığı anlamına gelir. |
| noshow_blocked | Bir 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_restricted | Bir booking_refused mesajı: üye, dersin en düşük yaş sınırının altında. Hata ageMin değerini taşır. |
| guardian_required | Bir booking_refused mesajı: üye reşit değil ve salon, kartında bir velinin adını ve telefonunu istiyor. |
| guardian_consent_required | Bir booking_refused mesajı: üye reşit değil ve salon, henüz kaydedilmemiş veli onayını istiyor. |
| payment_required | Bu rezervasyonun önce ödenmesi gerekir. Hata, üyenin ödeme sayfası olan payment_address değerini taşır. |
| no_consent | Bu üye henüz uygulamanıza bağlanmadı. |
| group_not_allowed | Bu 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?
Üyeler her seferinde bir onay ekranı görecek mi?
Kayıtlarımı e-postaya mı yoksa sub'a mı bağlamalıyım?
Üye numarası ve e-posta kimliği kanıtlamaya yeter mi?
Bir üyenin ders için paketi yoksa ne olur?
Hangi webhook olayları var?
API'yi yerelde nasıl test ederim?
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
Okumaya devam edin
İlgili
feature
Ders rezervasyonufeature
Üye yönetimifeature
Spor salonu otomasyonupricing
FiyatlandırmaÖzellik
Tüm özellikler