Aller au contenu principal

Obtenir les préférences de communication d'un client

GET

https://api-v2.test.eldowallet.fr/clients/:clientId/communication-preferences

Renvoie les préférences de communication d'un client : canaux autorisés (email, sms, notification) par type de notification, consentement aux notifications push informatives et commerciales, et lien vers la page publique où le client gère lui-même ses préférences (consentLink).

À retenir
  • Un type de notification ou un canal jamais réglé est considéré comme autorisé (true), de même que pushInformativeEnabled et pushCommercialEnabled. consentLink est absent si le client n'a pas de carte de fidélité.

Requête​

path parameters
  • clientId string required
    Identifiant du client (ObjectId de 24 caractères hexadécimaux).
header parameters
  • x-lang string
    Langue des messages d'erreur et des textes renvoyés : `fr` ou `en`.
    enum: en, frdefault: "en"

Réponses​

Schéma application/json
  • communicationPreferences object[] required
    • notificationType string requiredenum: NEW_LOYALTY, UPDATE_LOYALTY, REMINDER_LOYALTY, EARNINGS_UPDATE, NEW_COMMUNICATION, EXPIRED_COMMUNICATION, NEW_EVENT, UPDATE_EVENT, NEW_COUPON, UPDATE_COUPON, WELCOME_INTERNAL_CLIENTS, WELCOME_CRM_CLIENTS, WELCOME_EXTERNAL_CLIENTS, WELCOME_COUPON, EXPIRED_COUPON, TRANSIT_TICKET, UPDATE_TRANSIT, HOTEL_RESERVATION, UPDATE_HOTEL_RESERVATION, CINEMA_TICKET
    • sms boolean required
    • email boolean required
    • notification boolean required
  • pushInformativeEnabled boolean required
  • pushCommercialEnabled boolean required
  • consentLink string
    URL de la page publique de gestion des consentements (`/consent/:token`), sans connexion, sur laquelle le client gère lui-même ses préférences. Absente si le client n'a pas de carte de fidélité.

Les nouveautés de l'API, une fois par mois

Nouveaux endpoints, changements à prévoir, guides et cas d'usage. Pas de spam, désinscription en un clic.

Signaler un problème technique

Une erreur de l’API, un pass qui ne se met pas à jour, un e-mail qui n’arrive pas ? Décrivez le problème : notre équipe technique vous répond.

Pour une réponse rapide, indiquez :

  • La méthode et l’endpoint (ex. POST /clients)
  • Le code d’erreur renvoyé (errorCode) et le corps envoyé
  • La date et l’heure de l’appel
  • Les identifiants concernés (client, modèle, pass)

N’y mettez jamais de jeton d’API ni de mot de passe.

Assistant IA

Beta

Chargement…

Réponses générées par IA (Claude) : vérifiez les points importants.

Connectez-vous pour utiliser l'assistant