API Tokens de Notification

Endpoints pour la gestion des tokens de notification push des clients.

SDK: client.notificationToken

Endpoints

Enregistrer un token

Enregistre ou met à jour un token de notification pour un client.


POST /app/{appId}/customer/{customerId}/notification-token/set

Requête

Champ	Type	Requis	Description
`apiKey`	string	Oui	Clé API
`token`	string	Oui	Token de notification (FCM, APNs, etc.)
`platform`	string	Oui	Plateforme: `IOS`, `ANDROID`, `WEB`
`deviceId`	string	Non	Identifiant unique de l’appareil
`deviceName`	string	Non	Nom de l’appareil (ex: “iPhone de Jean”)


curl -X POST https://api.applite.ai/app/{appId}/customer/{customerId}/notification-token/set \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "your_api_key",
    "token": "fcm_token_abc123...",
    "platform": "ANDROID",
    "deviceId": "device_unique_id",
    "deviceName": "Samsung Galaxy S21"
  }'

Réponse


{
  "success": true,
  "data": {
    "id": "token_123",
    "customerId": "cust_123",
    "appId": "app_id",
    "token": "fcm_token_abc123...",
    "platform": "ANDROID",
    "deviceId": "device_unique_id",
    "deviceName": "Samsung Galaxy S21",
    "createdAt": "2024-01-15T10:00:00.000Z",
    "lastUsedAt": "2024-01-15T10:00:00.000Z"
  }
}

Erreurs

Code	Description
`not-authorized`	Clé API invalide
`customer-not-found`	Client non trouvé
`invalid-request`	Token ou plateforme invalide

Si le token existe déjà pour ce client, il sera mis à jour avec les nouvelles informations d’appareil.

Supprimer un token

Supprime un token de notification spécifique (déconnexion d’un appareil).


POST /app/{appId}/customer/{customerId}/notification-token/remove

Requête

Champ	Type	Requis	Description
`apiKey`	string	Oui	Clé API
`token`	string	Oui	Token à supprimer


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

Réponse


{
  "success": true,
  "data": {
    "removed": true
  }
}

Erreurs

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

Supprimer tous les tokens

Supprime tous les tokens d’un client (déconnexion de tous les appareils).


POST /app/{appId}/customer/{customerId}/notification-token/remove-all

Requête

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


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

Réponse


{
  "success": true,
  "data": {
    "removedCount": 3
  }
}

Erreurs

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

Utilisez cette méthode avec précaution. Elle déconnecte le client de tous ses appareils.

Lister les tokens

Liste tous les tokens de notification d’un client.


POST /app/{appId}/customer/{customerId}/notification-token/list

Requête

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


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

Réponse


{
  "success": true,
  "data": [
    {
      "id": "token_123",
      "customerId": "cust_123",
      "appId": "app_id",
      "token": "fcm_token_abc123...",
      "platform": "ANDROID",
      "deviceId": "device_1",
      "deviceName": "Samsung Galaxy S21",
      "createdAt": "2024-01-15T10:00:00.000Z",
      "lastUsedAt": "2024-01-20T08:00:00.000Z"
    },
    {
      "id": "token_456",
      "customerId": "cust_123",
      "appId": "app_id",
      "token": "apns_token_xyz789...",
      "platform": "IOS",
      "deviceId": "device_2",
      "deviceName": "iPhone 15 Pro",
      "createdAt": "2024-01-10T14:30:00.000Z",
      "lastUsedAt": "2024-01-19T16:45:00.000Z"
    }
  ]
}

Erreurs

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

Plateformes supportées

Plateforme	Description
`IOS`	Apple Push Notification service (APNs)
`ANDROID`	Firebase Cloud Messaging (FCM)
`WEB`	Web Push Notifications