01 · КЛЮЧ
Создайте API-ключ клуба
В Admin клуба → Cercle Connect создайте ключ ck_live_. Отвечает только за этот клуб — никогда другие.
02 · VERIFY
POST /connect/v1/verify
Отправьте Authorization: Bearer ck_live_… и { token } из QR паспорта. Получите name, city, score, memberSince + membership / paid — без email и телефона.
03 · ДОПУСК
Откройте дверь или сайт
Используйте membership none|member|admin и paid у себя. Бесплатные клубы тоже работают — membership = join/RSVP, не платный SKU.
ENDPOINT · V0
POST https://api.cercle.events/connect/v1/verify
Authorization: Bearer ck_live_…
{ "token": "<passport QR / credential>" }
→ 200 { ok, passport:{name,city,score,memberSince}, club:{id,membership,paid} }
→ 401 неверный ключ · 403 отказ · 404 не найденоС лимитом запросов. Предпочтительны серверные вызовы. Пока недоступно: OAuth2/OIDC, биллинг Connect, физический паспорт.
SOFT HOLD · НЕ В V0
Без OAuth2 / OIDC «Sign in with Cercle», без платы Connect, без marketplace, без cross-club графа, без физического паспорта.