PlayPad App

Général

Authentification

API consommée par app-native-playpad (Capacitor). Auth Firebase (email/password + Phone OTP). Les routes /auth/* et /players/connected/* sont publiques ; le reste exige API_KEY_PLAYPAD_APP en production. Session joueur = header x-firebase-id-token.

Préfixe /api/playpad-app/*
Clé API_KEY_PLAYPAD_APP (x-api-key ou Bearer)
Profil connecté : x-firebase-id-token

Client : NEXT_PUBLIC_API_URL_PLAYPAD_APP + NEXT_PUBLIC_API_KEY_PLAYPAD_APP

Public (sans clé)

/auth/register, /auth/phone/*, /auth/email/*
/players/connected/* (login, me, refresh…)

Toujours Content-Type: application/json

Parcours inscription (app-native)

1. Stepper /signup/infos → profil + email/password + téléphone
2. POST /auth/register (sans phone sur Firebase Auth ; SQL users+players)
3. Login email/password côté client + doc Firestore
4. POST /auth/phone/send (+ recaptchaToken)
5. POST /auth/phone/verify (sessionInfo + code + idToken pour lier le phone)
6. Suite onboarding : photo → formula → level → email → legal

Après register, status SQL typique : must_complete_photo. Ne pas coller le phone à Auth au register.

Récapitulatif des méthodes

Route	GET	POST	PATCH	DEL
/playpad-app/auth/email/login	—	✓	—	—
/playpad-app/auth/email/send	—	✓	—	—
/playpad-app/auth/email/verify	—	✓	—	—
/playpad-app/auth/phone/login	—	✓	—	—
/playpad-app/auth/phone/send	—	✓	—	—
/playpad-app/auth/phone/verify	—	✓	—	—
/playpad-app/auth/register	✓	✓	—	—
/playpad-app/players	✓	—	—	—
/playpad-app/players/[uid]	✓	—	—	—
/playpad-app/players/[uid]/matchs	✓	—	—	—
/playpad-app/players/available	✓	—	—	—
/playpad-app/players/available/count	✓	—	—	—
/playpad-app/players/connected	✓	—	—	—
/playpad-app/players/connected/login	—	✓	—	—
/playpad-app/players/connected/logout	—	✓	—	—
/playpad-app/players/connected/me	✓	—	✓	✓
/playpad-app/players/connected/refresh	—	✓	—	—
/playpad-app/players/connected/token	✓	—	—	—
/playpad-app/players/connected/verify	—	✓	—	—
/playpad-app/players/count	✓	—	—	—
/playpad-app/players/ranked	✓	—	—	—
/playpad-app/players/ranked/count	✓	—	—	—
/playpad-app/clubs	✓	—	—	—
/playpad-app/clubs/[uid]	✓	—	—	—
/playpad-app/clubs/search	✓	—	—	—
/playpad-app/matchs	✓	—	—	—
/playpad-app/matchs/[uid]	✓	✓	✓	✓
/playpad-app/matchs/count	✓	—	—	—
/playpad-app/matchs/home-page	✓	—	—	—
/playpad-app/matchs/open	✓	—	—	—
/playpad-app/matchs/recents	✓	—	—	—
/playpad-app/home-page/matchs	✓	—	—	—
/playpad-app/home-page/ranked-players	✓	—	—	—
/playpad-app/conversations	✓	—	—	—
/playpad-app/conversations/[uid]	✓	—	—	—
/playpad-app/conversations/[uid]/messages	✓	—	—	—
/playpad-app/notifications	✓	—	—	—
/playpad-app/notifications/[uid]	✓	—	—	—
/playpad-app/bookings	✓	—	—	—
/playpad-app/bookings/[uid]	✓	—	—	—
/playpad-app/transactions	✓	—	—	—
/playpad-app/transactions/[uid]	✓	—	—	—
/playpad-app/cities	✓	—	—	—
/playpad-app/cities/[uid]	✓	—	—	—
/playpad-app/cities/[uid]/provinces	✓	—	—	—
/playpad-app/provinces	✓	—	—	—
/playpad-app/settings	✓	✓	✓	✓

Application mobile

Auth (inscription & connexion)PlayPad App

POST

/playpad-app/auth/email/loginPublic · POST

Méthodes disponibles : POST. Accessible sans authentification.

Exemple cURL

curl "https://api.playpadapp.com/api/playpad-app/auth/email/login"

401

{ "success": false, "error": "Accès refusé : clé API manquante ou invalide." }

POST

/playpad-app/auth/email/sendPublic · POST

Méthodes disponibles : POST. Accessible sans authentification.

Exemple cURL

curl "https://api.playpadapp.com/api/playpad-app/auth/email/send"

401

{ "success": false, "error": "Accès refusé : clé API manquante ou invalide." }

POST

/playpad-app/auth/email/verifyPublic · POST

Méthodes disponibles : POST. Accessible sans authentification.

Exemple cURL

curl "https://api.playpadapp.com/api/playpad-app/auth/email/verify"

401

{ "success": false, "error": "Accès refusé : clé API manquante ou invalide." }

POST

/playpad-app/auth/phone/loginPublic · POST

Méthodes disponibles : POST. Accessible sans authentification.

Exemple cURL

curl "https://api.playpadapp.com/api/playpad-app/auth/phone/login"

401

{ "success": false, "error": "Accès refusé : clé API manquante ou invalide." }

POST

/playpad-app/auth/phone/sendPublic · POST

Méthodes disponibles : POST. Accessible sans authentification.

Exemple cURL

curl "https://api.playpadapp.com/api/playpad-app/auth/phone/send"

401

{ "success": false, "error": "Accès refusé : clé API manquante ou invalide." }

POST

/playpad-app/auth/phone/verifyPublic · POST

Méthodes disponibles : POST. Accessible sans authentification.

Exemple cURL

curl "https://api.playpadapp.com/api/playpad-app/auth/phone/verify"

401

{ "success": false, "error": "Accès refusé : clé API manquante ou invalide." }

GETPOST

/playpad-app/auth/registerPublic · GET, POST

Méthodes disponibles : GET, POST. Accessible sans authentification.

Exemple cURL

curl "https://api.playpadapp.com/api/playpad-app/auth/register"

401

{ "success": false, "error": "Accès refusé : clé API manquante ou invalide." }

JoueursPlayPad App

GET

/playpad-app/playersPlayPad App · GET

Méthodes disponibles : GET. Protégé par API_KEY_PLAYPAD_APP (header x-api-key ou Bearer).

Exemple cURL

# Token requis — x-api-key ou Authorization: Bearer <clé>

curl "https://api.playpadapp.com/api/playpad-app/players"

401

{ "success": false, "error": "Accès refusé : clé API manquante ou invalide." }

GET

/playpad-app/players/[uid]PlayPad App · GET

Méthodes disponibles : GET. Protégé par API_KEY_PLAYPAD_APP (header x-api-key ou Bearer).

Exemple cURL

# Token requis — x-api-key ou Authorization: Bearer <clé>

curl "https://api.playpadapp.com/api/playpad-app/players/[uid]"

401

{ "success": false, "error": "Accès refusé : clé API manquante ou invalide." }

GET

/playpad-app/players/[uid]/matchsPlayPad App · GET

Méthodes disponibles : GET. Protégé par API_KEY_PLAYPAD_APP (header x-api-key ou Bearer).

Exemple cURL

# Token requis — x-api-key ou Authorization: Bearer <clé>

curl "https://api.playpadapp.com/api/playpad-app/players/[uid]/matchs"

401

{ "success": false, "error": "Accès refusé : clé API manquante ou invalide." }

GET

/playpad-app/players/availablePlayPad App · GET

Méthodes disponibles : GET. Protégé par API_KEY_PLAYPAD_APP (header x-api-key ou Bearer).

Exemple cURL

# Token requis — x-api-key ou Authorization: Bearer <clé>

curl "https://api.playpadapp.com/api/playpad-app/players/available"

401

{ "success": false, "error": "Accès refusé : clé API manquante ou invalide." }

GET

/playpad-app/players/available/countPlayPad App · GET

Méthodes disponibles : GET. Protégé par API_KEY_PLAYPAD_APP (header x-api-key ou Bearer).

Exemple cURL

# Token requis — x-api-key ou Authorization: Bearer <clé>

curl "https://api.playpadapp.com/api/playpad-app/players/available/count"

401

{ "success": false, "error": "Accès refusé : clé API manquante ou invalide." }

GET

/playpad-app/players/connectedPublic · GET

Méthodes disponibles : GET. Accessible sans authentification.

Exemple cURL

curl "https://api.playpadapp.com/api/playpad-app/players/connected"

401

{ "success": false, "error": "Accès refusé : clé API manquante ou invalide." }

POST

/playpad-app/players/connected/loginPublic · POST

Méthodes disponibles : POST. Accessible sans authentification.

Exemple cURL

curl "https://api.playpadapp.com/api/playpad-app/players/connected/login"

401

{ "success": false, "error": "Accès refusé : clé API manquante ou invalide." }

POST

/playpad-app/players/connected/logoutPublic · POST

Méthodes disponibles : POST. Accessible sans authentification.

Exemple cURL

curl "https://api.playpadapp.com/api/playpad-app/players/connected/logout"

401

{ "success": false, "error": "Accès refusé : clé API manquante ou invalide." }

GETPATCHDELETE

/playpad-app/players/connected/mePublic · GET, PATCH, DELETE

Méthodes disponibles : GET, PATCH, DELETE. Accessible sans authentification.

Exemple cURL

curl "https://api.playpadapp.com/api/playpad-app/players/connected/me"

401

{ "success": false, "error": "Accès refusé : clé API manquante ou invalide." }

POST

/playpad-app/players/connected/refreshPublic · POST

Méthodes disponibles : POST. Accessible sans authentification.

Exemple cURL

curl "https://api.playpadapp.com/api/playpad-app/players/connected/refresh"

401

{ "success": false, "error": "Accès refusé : clé API manquante ou invalide." }

GET

/playpad-app/players/connected/tokenPublic · GET

Méthodes disponibles : GET. Accessible sans authentification.

Exemple cURL

curl "https://api.playpadapp.com/api/playpad-app/players/connected/token"

401

{ "success": false, "error": "Accès refusé : clé API manquante ou invalide." }

POST

/playpad-app/players/connected/verifyPublic · POST

Méthodes disponibles : POST. Accessible sans authentification.

Exemple cURL

curl "https://api.playpadapp.com/api/playpad-app/players/connected/verify"

401

{ "success": false, "error": "Accès refusé : clé API manquante ou invalide." }

GET

/playpad-app/players/countPlayPad App · GET

Méthodes disponibles : GET. Protégé par API_KEY_PLAYPAD_APP (header x-api-key ou Bearer).

Exemple cURL

# Token requis — x-api-key ou Authorization: Bearer <clé>

curl "https://api.playpadapp.com/api/playpad-app/players/count"

401

{ "success": false, "error": "Accès refusé : clé API manquante ou invalide." }

GET

/playpad-app/players/rankedPlayPad App · GET

Méthodes disponibles : GET. Protégé par API_KEY_PLAYPAD_APP (header x-api-key ou Bearer).

Exemple cURL

# Token requis — x-api-key ou Authorization: Bearer <clé>

curl "https://api.playpadapp.com/api/playpad-app/players/ranked"

401

{ "success": false, "error": "Accès refusé : clé API manquante ou invalide." }

GET

/playpad-app/players/ranked/countPlayPad App · GET

Méthodes disponibles : GET. Protégé par API_KEY_PLAYPAD_APP (header x-api-key ou Bearer).

Exemple cURL

# Token requis — x-api-key ou Authorization: Bearer <clé>

curl "https://api.playpadapp.com/api/playpad-app/players/ranked/count"

401

{ "success": false, "error": "Accès refusé : clé API manquante ou invalide." }

ClubsPlayPad App

GET

/playpad-app/clubsPlayPad App · GET

Méthodes disponibles : GET. Protégé par API_KEY_PLAYPAD_APP (header x-api-key ou Bearer).

Exemple cURL

# Token requis — x-api-key ou Authorization: Bearer <clé>

curl "https://api.playpadapp.com/api/playpad-app/clubs"

401

{ "success": false, "error": "Accès refusé : clé API manquante ou invalide." }

GET

/playpad-app/clubs/[uid]PlayPad App · GET

Méthodes disponibles : GET. Protégé par API_KEY_PLAYPAD_APP (header x-api-key ou Bearer).

Exemple cURL

# Token requis — x-api-key ou Authorization: Bearer <clé>

curl "https://api.playpadapp.com/api/playpad-app/clubs/[uid]"

401

{ "success": false, "error": "Accès refusé : clé API manquante ou invalide." }

GET

/playpad-app/clubs/searchPlayPad App · GET

Méthodes disponibles : GET. Protégé par API_KEY_PLAYPAD_APP (header x-api-key ou Bearer).

Exemple cURL

# Token requis — x-api-key ou Authorization: Bearer <clé>

curl "https://api.playpadapp.com/api/playpad-app/clubs/search"

401

{ "success": false, "error": "Accès refusé : clé API manquante ou invalide." }

MatchsPlayPad App

GET

/playpad-app/matchsPlayPad App · GET

Méthodes disponibles : GET. Protégé par API_KEY_PLAYPAD_APP (header x-api-key ou Bearer).

Exemple cURL

# Token requis — x-api-key ou Authorization: Bearer <clé>

curl "https://api.playpadapp.com/api/playpad-app/matchs"

401

{ "success": false, "error": "Accès refusé : clé API manquante ou invalide." }

GETPOSTPATCHDELETE

/playpad-app/matchs/[uid]PlayPad App · GET, POST, PATCH, DELETE

Méthodes disponibles : GET, POST, PATCH, DELETE. Protégé par API_KEY_PLAYPAD_APP (header x-api-key ou Bearer).

Exemple cURL

# Token requis — x-api-key ou Authorization: Bearer <clé>

curl "https://api.playpadapp.com/api/playpad-app/matchs/[uid]"

401

{ "success": false, "error": "Accès refusé : clé API manquante ou invalide." }

GET

/playpad-app/matchs/countPlayPad App · GET

Méthodes disponibles : GET. Protégé par API_KEY_PLAYPAD_APP (header x-api-key ou Bearer).

Exemple cURL

# Token requis — x-api-key ou Authorization: Bearer <clé>

curl "https://api.playpadapp.com/api/playpad-app/matchs/count"

401

{ "success": false, "error": "Accès refusé : clé API manquante ou invalide." }

GET

/playpad-app/matchs/home-pagePlayPad App · GET

Méthodes disponibles : GET. Protégé par API_KEY_PLAYPAD_APP (header x-api-key ou Bearer).

Exemple cURL

# Token requis — x-api-key ou Authorization: Bearer <clé>

curl "https://api.playpadapp.com/api/playpad-app/matchs/home-page"

401

{ "success": false, "error": "Accès refusé : clé API manquante ou invalide." }

GET

/playpad-app/matchs/openPlayPad App · GET

Méthodes disponibles : GET. Protégé par API_KEY_PLAYPAD_APP (header x-api-key ou Bearer).

Exemple cURL

# Token requis — x-api-key ou Authorization: Bearer <clé>

curl "https://api.playpadapp.com/api/playpad-app/matchs/open"

401

{ "success": false, "error": "Accès refusé : clé API manquante ou invalide." }

GET

/playpad-app/matchs/recentsPlayPad App · GET

Méthodes disponibles : GET. Protégé par API_KEY_PLAYPAD_APP (header x-api-key ou Bearer).

Exemple cURL

# Token requis — x-api-key ou Authorization: Bearer <clé>

curl "https://api.playpadapp.com/api/playpad-app/matchs/recents"

401

{ "success": false, "error": "Accès refusé : clé API manquante ou invalide." }

Home pagePlayPad App

GET

/playpad-app/home-page/matchsPlayPad App · GET

Méthodes disponibles : GET. Protégé par API_KEY_PLAYPAD_APP (header x-api-key ou Bearer).

Exemple cURL

# Token requis — x-api-key ou Authorization: Bearer <clé>

curl "https://api.playpadapp.com/api/playpad-app/home-page/matchs"

401

{ "success": false, "error": "Accès refusé : clé API manquante ou invalide." }

GET

/playpad-app/home-page/ranked-playersPlayPad App · GET

Méthodes disponibles : GET. Protégé par API_KEY_PLAYPAD_APP (header x-api-key ou Bearer).

Exemple cURL

# Token requis — x-api-key ou Authorization: Bearer <clé>

curl "https://api.playpadapp.com/api/playpad-app/home-page/ranked-players"

401

{ "success": false, "error": "Accès refusé : clé API manquante ou invalide." }

ConversationsPlayPad App

GET

/playpad-app/conversationsPlayPad App · GET

Méthodes disponibles : GET. Protégé par API_KEY_PLAYPAD_APP (header x-api-key ou Bearer).

Exemple cURL

# Token requis — x-api-key ou Authorization: Bearer <clé>

curl "https://api.playpadapp.com/api/playpad-app/conversations"

401

{ "success": false, "error": "Accès refusé : clé API manquante ou invalide." }

GET

/playpad-app/conversations/[uid]PlayPad App · GET

Méthodes disponibles : GET. Protégé par API_KEY_PLAYPAD_APP (header x-api-key ou Bearer).

Exemple cURL

# Token requis — x-api-key ou Authorization: Bearer <clé>

curl "https://api.playpadapp.com/api/playpad-app/conversations/[uid]"

401

{ "success": false, "error": "Accès refusé : clé API manquante ou invalide." }

GET

/playpad-app/conversations/[uid]/messagesPlayPad App · GET

Méthodes disponibles : GET. Protégé par API_KEY_PLAYPAD_APP (header x-api-key ou Bearer).

Exemple cURL

# Token requis — x-api-key ou Authorization: Bearer <clé>

curl "https://api.playpadapp.com/api/playpad-app/conversations/[uid]/messages"

401

{ "success": false, "error": "Accès refusé : clé API manquante ou invalide." }

NotificationsPlayPad App

GET

/playpad-app/notificationsPlayPad App · GET

Méthodes disponibles : GET. Protégé par API_KEY_PLAYPAD_APP (header x-api-key ou Bearer).

Exemple cURL

# Token requis — x-api-key ou Authorization: Bearer <clé>

curl "https://api.playpadapp.com/api/playpad-app/notifications"

401

{ "success": false, "error": "Accès refusé : clé API manquante ou invalide." }

GET

/playpad-app/notifications/[uid]PlayPad App · GET

Méthodes disponibles : GET. Protégé par API_KEY_PLAYPAD_APP (header x-api-key ou Bearer).

Exemple cURL

# Token requis — x-api-key ou Authorization: Bearer <clé>

curl "https://api.playpadapp.com/api/playpad-app/notifications/[uid]"

401

{ "success": false, "error": "Accès refusé : clé API manquante ou invalide." }

RéservationsPlayPad App

GET

/playpad-app/bookingsPlayPad App · GET

Méthodes disponibles : GET. Protégé par API_KEY_PLAYPAD_APP (header x-api-key ou Bearer).

Exemple cURL

# Token requis — x-api-key ou Authorization: Bearer <clé>

curl "https://api.playpadapp.com/api/playpad-app/bookings"

401

{ "success": false, "error": "Accès refusé : clé API manquante ou invalide." }

GET

/playpad-app/bookings/[uid]PlayPad App · GET

Méthodes disponibles : GET. Protégé par API_KEY_PLAYPAD_APP (header x-api-key ou Bearer).

Exemple cURL

# Token requis — x-api-key ou Authorization: Bearer <clé>

curl "https://api.playpadapp.com/api/playpad-app/bookings/[uid]"

401

{ "success": false, "error": "Accès refusé : clé API manquante ou invalide." }

TransactionsPlayPad App

GET

/playpad-app/transactionsPlayPad App · GET

Méthodes disponibles : GET. Protégé par API_KEY_PLAYPAD_APP (header x-api-key ou Bearer).

Exemple cURL

# Token requis — x-api-key ou Authorization: Bearer <clé>

curl "https://api.playpadapp.com/api/playpad-app/transactions"

401

{ "success": false, "error": "Accès refusé : clé API manquante ou invalide." }

GET

/playpad-app/transactions/[uid]PlayPad App · GET

Méthodes disponibles : GET. Protégé par API_KEY_PLAYPAD_APP (header x-api-key ou Bearer).

Exemple cURL

# Token requis — x-api-key ou Authorization: Bearer <clé>

curl "https://api.playpadapp.com/api/playpad-app/transactions/[uid]"

401

{ "success": false, "error": "Accès refusé : clé API manquante ou invalide." }

VillesPlayPad App

GET

/playpad-app/citiesPlayPad App · GET

Méthodes disponibles : GET. Protégé par API_KEY_PLAYPAD_APP (header x-api-key ou Bearer).

Exemple cURL

# Token requis — x-api-key ou Authorization: Bearer <clé>

curl "https://api.playpadapp.com/api/playpad-app/cities"

401

{ "success": false, "error": "Accès refusé : clé API manquante ou invalide." }

GET

/playpad-app/cities/[uid]PlayPad App · GET

Méthodes disponibles : GET. Protégé par API_KEY_PLAYPAD_APP (header x-api-key ou Bearer).

Exemple cURL

# Token requis — x-api-key ou Authorization: Bearer <clé>

curl "https://api.playpadapp.com/api/playpad-app/cities/[uid]"

401

{ "success": false, "error": "Accès refusé : clé API manquante ou invalide." }

GET

/playpad-app/cities/[uid]/provincesPlayPad App · GET

Méthodes disponibles : GET. Protégé par API_KEY_PLAYPAD_APP (header x-api-key ou Bearer).

Exemple cURL

# Token requis — x-api-key ou Authorization: Bearer <clé>

curl "https://api.playpadapp.com/api/playpad-app/cities/[uid]/provinces"

401

{ "success": false, "error": "Accès refusé : clé API manquante ou invalide." }

ProvincesPlayPad App

GET

/playpad-app/provincesPlayPad App · GET

Méthodes disponibles : GET. Protégé par API_KEY_PLAYPAD_APP (header x-api-key ou Bearer).

Exemple cURL

# Token requis — x-api-key ou Authorization: Bearer <clé>

curl "https://api.playpadapp.com/api/playpad-app/provinces"

401

{ "success": false, "error": "Accès refusé : clé API manquante ou invalide." }

ParamètresPlayPad App

GETPOSTPATCHDELETE

/playpad-app/settingsPlayPad App · GET, POST, PATCH, DELETE

Méthodes disponibles : GET, POST, PATCH, DELETE. Protégé par API_KEY_PLAYPAD_APP (header x-api-key ou Bearer).

Exemple cURL

# Token requis — x-api-key ou Authorization: Bearer <clé>

curl "https://api.playpadapp.com/api/playpad-app/settings"

401

{ "success": false, "error": "Accès refusé : clé API manquante ou invalide." }