New: an AI assistant that answers with your gym's real numbers. See how it works
Клиенты и CRMПрофили, посещаемость и заметкиПлатежи и счетаАбонементы и онлайн-платежиЯзыкиКаждый выбирает свой языкТайский языкСотрудники, клиенты и квитанции на тайскомОтслеживание прогрессаРезультаты, рекорды и оценка телосложенияКассаMaxРозница на стойке и складОтметка и киоскБыстрая отметка на стойкеРасписание и записиЗанятия, вместимость и листы ожиданияВыбор местаProКлиенты выбирают велосипед или реформерСообщенияLINE и почта. WhatsApp и SMS на тарифе MaxКабинет клиента и порталСамостоятельная запись и отметкаОтчёты и аналитикаProВыручка, удержание, посещаемостьАвтоматизацииProНапоминания и сценарииEmail-рассылкиProNewОдно письмо выбранной группеИИ-ассистентMaxNewГотовит работу, решаете выAPI и интеграцииProПодключите свой сайт и приложенияИнтеграцииLINE, Stripe, PromptPay и ваш сайтВсе функцииВсе функции, сгруппированные по задачам
Посмотрите вживуюПолная программа с демо-данными. Аккаунт не нужен.Открыть демо
Что вы проводите?Muay ThaiYogaCrossFitPilatesBoxingSwimmingЗанятия, клиенты, цены и формулировки, заданные для Muay ThaiПопробуйте для своего направленияДемо меняет занятия, клиентов, цены и слова под ваш бизнес.Выберите направление

API v1 · OpenID Connect

Подключите сайт к вашему залу.

Пусть участники входят на ваш сайт через аккаунт зала, проверяют абонемент, записываются на занятия и видят расписание. Стандартный OpenID Connect, компактный REST API и подписанные вебхуки.

  • OpenID Connect
  • PKCE обязателен
  • Подписанные вебхуки

Прочитать условия API

01 · Быстрый старт

Быстрый старт с API MoveMembers: вход, обмен, чтение.

Участники входят через аккаунт зала. Ваш сайт получает подписанный ответ с номером участника, поэтому подойдёт любая библиотека OIDC.

01

Добавьте кнопку

Отправьте клиента на страницу входа его зала. PKCE обязателен для каждого приложения, конфиденциального или публичного.

Запрос авторизацииHTML
<!-- "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

Обменяйте код на вашем сервере

Вы получаете ID-токен, подписанный залом (ES256, ключи по адресу /oauth/jwks). Никогда не выполняйте этот обмен со страницы: для него нужен секрет клиента.

Пример кодаNode.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

Прочитайте claims

Только то, что проверил зал и одобрил участник. Привязывайте свою запись к "sub", а не к адресу электронной почты.

Поля ID-токенаJSON
{
  "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 · Проверка участника

Проверяйте номер участника и e-mail вместе.

Сервер к серверу, с токеном приложения (client_credentials, scope=lookup). Передавайте их в теле запроса, а не в адресе: адрес попадает в журналы сервера.

Ответ всегда 200 с одним полем "active", поэтому через вашу форму нельзя выяснить, кто является участником. Ошибкой 400 invalid_request отвечает только некорректное тело запроса.

Рецепты

Рецепты для API зала.

Каждый метод записи использует те же правила, что и приложения самого зала: окна записи, листы ожидания, проверку тарифов.

Привяжите запись

Привязать запись на вашем сайте к клиенту

Собака, шкафчик, автомобиль: храните "sub" в своей записи как внешний ключ, а не e-mail. Статус можно позже перепроверить с токеном приложения.

Открыть руководство

Записаться на занятие

Запись или отмена от имени участника

Получите расписание, затем запишите участника с его токеном доступа. У ответа "booking_refused" всегда есть понятная участнику причина: показывайте error.message.

Открыть руководство

Расписание и цены

Покажите расписание и цены

Публичная информация, вход участника не требуется. Одного токена приложения со scope=schedule достаточно, чтобы читать /schedule и /offers.

Открыть руководство

Проверьте, затем назначьте группу

Подтвердить личность через третью сторону, затем задать группу

Провайдер передаёт результат на ваш сервер, а не на страницу в браузере. Отправляйте только группу, которую заслужил участник, и никаких персональных данных.

Открыть руководство

05 · Вебхуки

Подписанные вебхуки, проверка в несколько строк.

member.connected, member.disconnected, member.status_changed, booking.created, booking.cancelled, payment.completed, member.group_changed. Если ответа 2xx нет, повторная отправка до 5 раз в течение примерно 3 часов.

Проверяйте подпись по необработанному (RAW) телу запроса, отклоняйте всё, что подписано более 5 минут назад, затем убирайте дубликаты по X-Webhook-Id. Секрет подписи показывается один раз, на вкладке Webhooks приложения.

10 · Справочник

Все методы API MoveMembers.

Везде JSON. Ничто не работает иначе из-за того, что запрос пришёл с вашего сайта.

СпособПутьЧто она делаетАвторизация
GET/.well-known/openid-configurationДокумент обнаруженияnone
GET/oauth/jwksПубличные ключи подписиnone
GET/oauth/authorizeНачать вход или регистрациюnone
POST/oauth/tokenОбменять код, обновить или получить токен приложенияключи доступа приложения
GET/oauth/userinfoДанные вошедшего клиентаmember, Bearer
POST/oauth/revokeОтозвать токенключи доступа приложения
GET/api/v1/meВошедший клиентmember, Bearer
GET/api/v1/me/bookingsЕго записи и тарифы (остаток занятий, даты, сумма к оплате)member, Bearer
POST/api/v1/bookingsЗаписать на занятие от его имениmember, Bearer
DELETE/api/v1/bookings/{id}Отменить записьmember, Bearer
GET/api/v1/members/{member_number}Проверка клиента по номеруприложение, scope=lookup
POST/api/v1/members/verifyПроверить номер клиента и e-mail вместеприложение, scope=lookup
GET/api/v1/scheduleПубличное расписание занятийприложение, scope=schedule
GET/api/v1/offersТарифы и продукты в открытой продажеприложение, scope=schedule
GET/api/v1/groupsГруппы, которые может задавать это приложениеприложение, scope=groups
PUT/api/v1/members/{member_number}/groupНазначить (или сбросить) группу клиентаприложение, scope=groups

Без согласия участника работают только GET /members/{member_number} и POST /members/verify, и они возвращают лишь сведения о том, действует ли абонемент.

12 · Лимиты запросов

Лимиты запросов в минуту.

При превышении лимита API отвечает 429 rate_limited с заголовком Retry-After. У каждого типа вызовов свой лимит, поэтому интенсивное чтение не расходует лимит на записи.

300вызовов чтения на приложение / мин/me, /me/bookings, /schedule, /offers, /groups
120вызовов записи на приложение / минзаписи и группы
120проверок участников на приложение / минодин общий лимит для lookup и verify
600вызовов в минуту на /api/v1общий для всех приложений одного зала

11 · Ошибки

Ошибки в одном формате везде.

Каждая ошибка /api/v1 выглядит так: { "error": { "code", "message", "request_id" } }. Конечные точки /oauth сохраняют стандартный формат OAuth, поэтому библиотеки OAuth работают без доработок.

КодЗначение
invalid_requestЗапрос некорректен: неизвестное поле или опечатка в нём, отсутствует параметр либо слишком большое тело запроса.
invalid_tokenТокен доступа отсутствует, просрочен или отозван.
insufficient_scopeУ токена нет области доступа, нужной этому эндпоинту.
capability_offЗал не включил эту возможность для вашего приложения.
plan_requiredСейчас тариф зала не включает подключённые приложения. Ничего не удаляется: всё вернётся, как только зал перейдёт на более высокий тариф.
not_foundТакого ресурса нет (или он не принадлежит этому залу).
rate_limitedСлишком много запросов. Подождите столько секунд, сколько указано в заголовке Retry-After, и повторите.
booking_refusedПравила записи отклонили этот запрос, причина указана в message. Сообщение, начинающееся с membership_, означает, что запись не создана.
noshow_blockedСообщение booking_refused: клиент достиг лимита неявок, установленного залом, и пока не может записываться онлайн. Ошибка содержит count, threshold и windowDays.
age_restrictedСообщение booking_refused: клиент младше минимального возраста для занятия. Ошибка содержит ageMin.
guardian_requiredСообщение booking_refused: клиент несовершеннолетний, а залу нужны имя и телефон опекуна в карточке.
guardian_consent_requiredСообщение booking_refused: клиент несовершеннолетний, а залу нужно согласие опекуна, которое пока не внесено.
payment_requiredЭту запись нужно сначала оплатить. В ошибке есть payment_address, страница оплаты участника.
no_consentЭтот клиент ещё не подключился к вашему приложению.
group_not_allowedЭта группа не включена залом для вашего приложения.

request_id также приходит в заголовке X-Request-Id: назовите его, когда обращаетесь за помощью, и мы найдём ваш вызов в журнале.

Вопросы

Вопросы об API MoveMembers.

Какой стандарт входа использует API MoveMembers?
Стандартный OpenID Connect с PKCE, обязательный для каждого приложения, конфиденциального или публичного. Подойдёт любая сертифицированная клиентская библиотека OIDC, а документ обнаружения находится по адресу /.well-known/openid-configuration.
Будут ли участники видеть экран согласия каждый раз?
Нет. Экран входа пропускается, пока участник остаётся в системе зала на этом устройстве, а подтверждение показывается один раз для каждого участника и приложения. Не используйте prompt=login, prompt=consent и max_age без необходимости.
К чему привязывать записи: к e-mail или к sub?
К "sub". Для этого участника и этого приложения он не меняется, даже если участник сменит e-mail. Значение "email_verified": false считайте непроверенным адресом.
Достаточно ли номера участника и e-mail, чтобы подтвердить личность?
Нет. Это лишь показывает, что кто-то знает эти данные, а не что он и есть участник. Чтобы убедиться, что это владелец аккаунта, используйте кнопку входа и считайте его "sub".
Что будет, если у участника нет подходящего тарифа для занятия?
Запись отвечает booking_refused с сообщением, начинающимся с membership_, и не создаётся. Прочитайте GET /me/bookings и направьте участника купить тариф.
Какие события вебхуков доступны?
member.connected, member.disconnected, member.status_changed, booking.created, booking.cancelled, payment.completed и member.group_changed, доставляются подписанными POST-запросами.
Как протестировать API локально?
Зарегистрируйте http://localhost (любой порт) как адрес возврата: это единственный адрес, который принимается по обычному http. Перед запуском добавьте свой настоящий рабочий адрес.

Стройте на основе вашего зала. Начните со своего аккаунта.

Создайте студию, зарегистрируйте приложение и адрес возврата localhost и проверьте весь сценарий.

  • 14 дн. тарифа Max бесплатно
  • Без банковской карты
  • Без звонка продавца