Nuevo: un asistente de IA que responde con los datos reales de tu gimnasio. Descubrir

API v1 · OpenID Connect

Conecta tu web con tu gimnasio.

Deja que tus miembros inicien sesión con su cuenta del gimnasio, comprueba una membresía, reserva clases y muestra tu horario en tu propia web. OpenID Connect estándar, una API REST sencilla y webhooks firmados.

  • OpenID Connect
  • PKCE obligatorio
  • Webhooks firmados

Leer los términos de la API

01 · Inicio rápido

Inicio rápido de la API de MoveMembers: iniciar sesión, intercambiar, leer.

Los miembros inician sesión con su cuenta del gimnasio. Tu web recibe una respuesta firmada con su número de miembro, así que sirve cualquier biblioteca OIDC.

01

Añade el botón

Envía al miembro a la página de inicio de sesión de su gimnasio. PKCE es obligatorio para todas las apps, confidenciales o públicas.

Solicitud de autorizaciónHTML
<!-- "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

Intercambiar el código en su servidor

Recibes un ID token firmado por el gimnasio (ES256, claves en /oauth/jwks). No hagas nunca este intercambio desde una página: requiere tu client secret.

Ejemplo de códigoNode.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

Leer los claims

Solo lo que el gimnasio ha comprobado y el miembro ha aprobado. Vincula tu registro a "sub", nunca al correo electrónico.

Claims del ID tokenJSON
{
  "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 · Comprobar un miembro

Comprueba un número de miembro y un correo a la vez.

De servidor a servidor, con un token de app (client_credentials, scope=lookup). Envíelos en el cuerpo, nunca en la dirección: una dirección acaba en los registros del servidor.

La respuesta es siempre 200 con un único campo, "active", así nadie puede usar tu formulario para averiguar quién es miembro. Solo un cuerpo mal formado responde 400 invalid_request.

Recetas

Recetas para la API del gimnasio.

Cada endpoint de escritura aplica exactamente las mismas reglas que las apps del propio gimnasio: ventanas de reserva, listas de espera, comprobación de planes.

Vincular un registro

Vincular un registro de su sitio a un miembro

Un perro, una taquilla, un coche: guarda "sub" en tu propio registro como clave foránea, nunca el correo. Vuelve a comprobar el estado más tarde con un token de app.

Ver la guía

Reservar una clase

Reservar o cancelar en nombre del miembro

Lista el horario y reserva con su token de acceso. Un "booking_refused" siempre incluye un motivo que el miembro entiende: muestra error.message.

Ver la guía

Horario y precios

Mostrar su horario y sus precios

Información pública, sin necesidad de que el miembro inicie sesión. Un token de app con scope=schedule lee /schedule y /offers.

Ver la guía

Verificar y luego asignar un grupo

Verificar la identidad con un tercero y luego asignar un grupo

El proveedor llama a tu servidor con el resultado, nunca a una página del navegador. Envía solo el grupo que el miembro se ha ganado, nunca datos de identidad.

Ver la guía

05 · Webhooks

Webhooks firmados, verificados en pocas líneas.

member.connected, member.disconnected, member.status_changed, booking.created, booking.cancelled, payment.completed, member.group_changed. Se reintenta hasta 5 veces durante unas 3 horas si no hay respuesta 2xx.

Verifica sobre el cuerpo RAW, rechaza todo lo firmado hace más de 5 minutos y deduplica por X-Webhook-Id. El secreto de firma se muestra una sola vez, en la pestaña Webhooks de la app.

10 · Referencia

Todos los endpoints de la API de MoveMembers.

JSON en todas partes. Nada se comporta distinto por venir de tu web.

MedioRutaQué haceAutenticación
GET/.well-known/openid-configurationDocumento de descubrimientonone
GET/oauth/jwksClaves de firma públicasnone
GET/oauth/authorizeIniciar un acceso o un registronone
POST/oauth/tokenIntercambiar un código, renovar u obtener un token de appcredenciales de la app
GET/oauth/userinfoLos claims del miembro con sesión iniciadamember, Bearer
POST/oauth/revokeRevocar un tokencredenciales de la app
GET/api/v1/meEl miembro con sesión iniciadamember, Bearer
GET/api/v1/me/bookingsSus reservas y sus planes (clases restantes, fechas, importe pendiente)member, Bearer
POST/api/v1/bookingsReservar una clase en su nombremember, Bearer
DELETE/api/v1/bookings/{id}Cancelar una reservamember, Bearer
GET/api/v1/members/{member_number}Comprobar a un miembro por su númeroapp, scope=lookup
POST/api/v1/members/verifyComprobar juntos un número de miembro y un correoapp, scope=lookup
GET/api/v1/scheduleHorario público de clasesapp, scope=schedule
GET/api/v1/offersPlanes y productos en venta públicaapp, scope=schedule
GET/api/v1/groupsGrupos que esta app puede asignarapp, scope=groups
PUT/api/v1/members/{member_number}/groupAsignar (o quitar) el grupo de un miembroapp, scope=groups

Solo GET /members/{member_number} y POST /members/verify funcionan sin el consentimiento del miembro, y no devuelven nada más allá de si la membresía está activa.

12 · Límites de uso

Límites de uso, contados por minuto.

Si superas un límite, la API responde 429 rate_limited con una cabecera Retry-After. Cada tipo de llamada tiene su propio presupuesto, así que leer mucho nunca agota tus reservas.

300llamadas de lectura por app / min/me, /me/bookings, /schedule, /offers, /groups
120llamadas de escritura por app / minreservas y grupos
120comprobaciones de miembros por app / minun único presupuesto compartido para consulta y verificación
600llamadas por minuto en /api/v1compartido por todas las apps de un mismo gimnasio

11 · Errores

Errores, con un único formato en todas partes.

Todos los errores de /api/v1 tienen la forma { "error": { "code", "message", "request_id" } }. Los endpoints /oauth mantienen el formato estándar de OAuth, así que las bibliotecas de OAuth funcionan tal cual.

CódigoSignificado
invalid_requestLa solicitud está mal formada: un campo desconocido o mal escrito, un parámetro que falta o un cuerpo demasiado grande.
invalid_tokenFalta el token bearer, o está caducado o revocado.
insufficient_scopeEl token no incluye el alcance que necesita este endpoint.
capability_offEl gimnasio no ha habilitado esta capacidad para tu app.
plan_requiredEl plan del gimnasio no incluye ahora las apps conectadas. No se borra nada; vuelve en cuanto mejoren de plan.
no hay conversación abierta con esta personaEse recurso no existe (o no pertenece a este gimnasio).
rate_limitedDemasiadas solicitudes. Espera los segundos indicados en la cabecera Retry-After y vuelve a intentarlo.
booking_refusedLas reglas de reserva rechazaron esta solicitud; message explica el motivo. Un mensaje que empieza por membership_ significa que no se creó ninguna reserva.
noshow_blockedUn mensaje de booking_refused: el miembro ha alcanzado el límite de ausencias del gimnasio y por ahora no puede reservar en línea. El error incluye count, threshold y windowDays.
age_restrictedUn mensaje de booking_refused: el miembro no tiene la edad mínima de la clase. El error incluye ageMin.
guardian_requiredUn mensaje de booking_refused: el miembro es menor y el gimnasio exige el nombre y el teléfono de un tutor en su ficha.
guardian_consent_requiredUn mensaje de booking_refused: el miembro es menor y el gimnasio exige el consentimiento del tutor, que aún no está registrado.
payment_requiredEsta reserva debe pagarse primero. El error incluye payment_address, la página de pago del miembro.
no_consentEse miembro todavía no se ha conectado a tu app.
group_not_allowedEse grupo no es uno de los que el gimnasio habilitó para tu app.

request_id también se envía en la cabecera X-Request-Id: cítalo cuando pidas ayuda, así encontramos tu llamada en el registro.

Preguntas

Preguntas sobre la API de MoveMembers.

¿Qué estándar de inicio de sesión usa la API de MoveMembers?
OpenID Connect estándar con PKCE, obligatorio para toda app, confidencial o pública. Sirve cualquier biblioteca cliente OIDC certificada, y el documento de descubrimiento está en /.well-known/openid-configuration.
¿Los miembros verán una pantalla de consentimiento cada vez?
No. La pantalla de inicio de sesión se omite mientras sigan con la sesión abierta en el gimnasio en ese dispositivo, y la aprobación se muestra una sola vez por miembro y por app. Evite prompt=login, prompt=consent y max_age salvo que realmente los necesite.
¿Debo vincular mis registros al correo o a sub?
A "sub". No cambia nunca para este miembro y esta app, aunque cambie de correo. Trata "email_verified": false como no verificado.
¿Basta un número de miembro y un correo para probar la identidad?
No. Demuestra que alguien los conoce, no que sea el miembro. Para asegurarte de que es el titular de la cuenta, usa el botón de inicio de sesión y lee su "sub".
¿Qué pasa cuando un miembro no tiene un plan válido para una clase?
La reserva responde booking_refused con un mensaje que empieza por membership_, y no se crea ninguna reserva. Lee GET /me/bookings y envía al miembro a comprar un plan.
¿Qué eventos de webhook hay disponibles?
member.connected, member.disconnected, member.status_changed, booking.created, booking.cancelled, payment.completed y member.group_changed, entregados como POST firmados.
¿Cómo pruebo la API en local?
Registra http://localhost (cualquier puerto) como dirección de retorno: es la única dirección aceptada por http simple. Añade tu dirección real de producción antes de salir en vivo.

Construya sobre su gimnasio. Empieza con tu propia cuenta.

Crea tu estudio, registra una app y una dirección de retorno localhost, y prueba todo el flujo.

  • 14 días de Max gratis
  • Sin tarjeta de crédito
  • Sin llamada comercial