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 графа, без фізичного паспорта.