API Clients

Endpoints pour la gestion des clients de votre application.

SDK: client.app.customer

Endpoints

Lister les clients

Liste tous les clients de l’application avec filtrage optionnel par plateforme.


POST /app/{appId}/customer/list

Requête

Champ	Type	Requis	Description
`apiKey`	string	Oui	Clé API
`plateformType`	string[]	Non	Filtrer par type: `store`, `transport`, `restauration`, `multiService`, `eLearning`


curl -X POST https://api.applite.ai/app/{appId}/customer/list \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "your_api_key",
    "plateformType": ["store", "multiService"]
  }'

Réponse


{
  "success": true,
  "data": [
    {
      "id": "cust_123",
      "fullname": "Jean Dupont",
      "email": "jean@example.com",
      "telephone": "+225070000000",
      "photoUrl": "https://...",
      "plateformType": "store",
      "createdAt": "2024-01-15T10:00:00.000Z"
    }
  ]
}

Erreurs

Code	Description
`not-authorized`	Clé API invalide
`app-not-found`	Application non trouvée

Authentifier/Créer un client

Authentifie un client existant ou en crée un nouveau.


POST /app/{appId}/customer/auth

Requête

Champ	Type	Requis	Description
`apiKey`	string	Oui	Clé API
`fullname`	string	Oui	Nom complet
`telephone`	string	Oui	Numéro de téléphone
`email`	string	Non	Adresse email
`plateform`	string	Non	Type de plateforme


curl -X POST https://api.applite.ai/app/{appId}/customer/auth \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "your_api_key",
    "fullname": "Jean Dupont",
    "telephone": "+225070000000",
    "email": "jean@example.com",
    "plateform": "store"
  }'

Réponse


{
  "success": true,
  "data": {
    "id": "cust_123",
    "fullname": "Jean Dupont",
    "email": "jean@example.com",
    "telephone": "+225070000000",
    "plateformType": "store",
    "createdAt": "2024-01-15T10:00:00.000Z"
  }
}

Erreurs

Code	Description
`not-authorized`	Clé API invalide
`invalid-request`	Paramètres manquants ou invalides

Vérifier un client

Vérifie si un client existe pour un numéro de téléphone donné.


POST /app/{appId}/customer/check

Requête

Champ	Type	Requis	Description
`apiKey`	string	Oui	Clé API
`telephone`	string	Oui	Numéro de téléphone
`plateform`	string	Non	Type de plateforme


curl -X POST https://api.applite.ai/app/{appId}/customer/check \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "your_api_key",
    "telephone": "+225070000000"
  }'

Lister (version légère)

Retourne une liste simplifiée des clients pour les interfaces rapides.


POST /app/{appId}/customer/list/few

Requête

Champ	Type	Requis	Description
`apiKey`	string	Oui	Clé API
`plateformType`	string[]	Non	Filtrer par type


curl -X POST https://api.applite.ai/app/{appId}/customer/list/few \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "your_api_key"
  }'

Obtenir un client

Récupère les détails complets d’un client avec son activité.


POST /app/{appId}/customer/{id}

Requête

Champ	Type	Requis	Description
`apiKey`	string	Oui	Clé API


curl -X POST https://api.applite.ai/app/{appId}/customer/{customerId} \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "your_api_key"
  }'

Réponse


{
  "success": true,
  "data": {
    "id": "cust_123",
    "fullname": "Jean Dupont",
    "email": "jean@example.com",
    "telephone": "+225070000000",
    "photoUrl": "https://...",
    "gender": "M",
    "dob": "1990-01-15",
    "country": "CI",
    "addresses": [],
    "transactions": [],
    "reviews": [],
    "createdAt": "2024-01-15T10:00:00.000Z",
    "updatedAt": "2024-01-20T14:30:00.000Z"
  }
}

Erreurs

Code	Description
`customer-not-found`	Client non trouvé
`not-authorized`	Clé API invalide

Mettre à jour un client

Met à jour les informations d’un client.


POST /app/{appId}/customer/{id}/update

Requête

Champ	Type	Requis	Description
`apiKey`	string	Oui	Clé API
`fullname`	string	Non	Nouveau nom
`email`	string	Non	Nouvel email
`photoUrl`	string	Non	URL de la photo
`photoId`	string	Non	ID du fichier photo
`gender`	string	Non	Genre: `M` ou `F`
`dob`	string	Non	Date de naissance (YYYY-MM-DD)
`country`	string	Non	Code pays (ISO)


curl -X POST https://api.applite.ai/app/{appId}/customer/{id}/update \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "your_api_key",
    "fullname": "Jean-Pierre Dupont",
    "email": "jp.dupont@example.com"
  }'