API Membres - Loyauté
Points de terminaison pour valider les membres, créer de nouveaux comptes et gérer les profils membres pour l'API Loyauté.
/api/v1/loyalty/
Valider un Membre
/api/v1/loyalty/members/validate
Vérifier si un numéro de téléphone est membre d'une carte de fidélité spécifique (points ou timbres).
Étape par Étape
Collecter le Numéro de Téléphone
Obtenez le numéro de téléphone du client au format E.164 (ex: +21612345678).
Envoyer la Demande de Validation
Envoyez une requête POST au point de terminaison members/validate avec card_id et phone_number.
Vérifier la Réponse
Le champ is_member vous indique s'ils sont inscrits.
Corps de la Requête
{
"card_id": 5,
"phone_number": "+21612345678",
"include_member_data": false
}Réponse
{
"success": true,
"data": {
"card_id": 5,
"phone_number": "+21612345678",
"is_member": true,
"validated_at": "2025-01-15T10:30:00Z"
}
}Créer un Membre
/api/v1/loyalty/members
Créer un nouveau compte membre et l'associer automatiquement à la carte.
Étape par Étape
Demander l'OTP
Envoyez une demande POST à /api/v1/auth/member/request-otp avec l'email du membre.
Vérifier l'OTP
Envoyez une demande POST à /api/v1/auth/member/verify-otp pour obtenir le X-Member-Token.
Créer le Membre
Envoyez une demande POST à members/ avec le token dans l'en-tête X-Member-Token.
En-têtes
X-App-Id: app_abc123...
X-Api-Key: test_xyz789...
X-Member-Token: eyJ0eXAiOiJKV1QiLCJhbGc...
Content-Type: application/jsonCorps de la Requête
{
"card_id": 5,
"name": "Jean Dupont",
"email": "jean.dupont@example.com",
"phone_number": "+21612345678",
"verification_code": "123456"
}Obtenir le Profil Membre
/api/v1/loyalty/members/{id}
Récupérer le profil et le solde d'un membre pour une carte spécifique.
Réponse
{
"success": true,
"data": {
"member": {
"id": 123,
"name": "Jean Dupont",
"email": "jean.dupont@example.com",
"phone": "+21612345678",
"created_at": "2025-01-15T10:30:00Z"
},
"card": {
"id": 5,
"name": "Carte Café Premium",
"reward_system": "points",
"points_balance": 150,
"joined_at": "2025-01-15T10:30:00Z"
}
}
}Mettre à Jour le Profil Membre
/api/v1/loyalty/members/{id}
Mettre à jour le nom du membre et les préférences de communication.
Corps de la Requête
{
"name": "Jean Dupont",
"accepts_emails": true,
"accepts_text_messages": false
}