01 · KLUCZ
Utwórz klucz API klubu
W Admin klubu → Cercle Connect utwórz klucz ck_live_. Odpowiada tylko za ten klub — nigdy inne.
02 · WERYFIKUJ
POST /connect/v1/verify
Wyślij Authorization: Bearer ck_live_… i { token } z QR paszportu. Dostajesz name, city, score, memberSince + membership / paid — bez e-maila i telefonu.
03 · WPUŚĆ
Otwórz drzwi lub stronę
Użyj membership none|member|admin i paid po swojej stronie. Darmowe kluby też działają — membership to join/RSVP, nie płatny 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 zły klucz · 403 odmowa · 404 brakLimit zapytań. Preferuj wywołania serwerowe. Jeszcze niedostępne: OAuth2/OIDC, billing Connect, paszport fizyczny.
SOFT HOLD · NIE W V0
Bez OAuth2 / OIDC „Sign in with Cercle”, bez opłaty Connect, bez marketplace, bez grafu cross-club, bez fizycznego paszportu.