Témoignages (TestimonyApi)

Le module TestimonyApi gère les témoignages clients. Les témoignages passent par un workflow d’approbation (PENDING → APPROVED/REJECTED).

Accès : client.testimony

Méthodes

`create`

Crée un nouveau témoignage (admin).

Exemple


const response = await client.testimony.create({
  appId: "app_id",
  apiKey: "user_api_key",
  name: "Jean Dupont",
  comment: "Excellent service !",
  rating: 5,
  status: "APPROVED"
});

Paramètres

Champ	Type	Requis	Description
`appId`	string	Oui	ID de l’application
`apiKey`	string	Oui	Clé API
`name`	string	Oui	Nom de l’auteur
`comment`	string	Oui	Contenu
`rating`	number	Non	Note (1-5)
`status`	string	Non	`PENDING`, `APPROVED`, `REJECTED`
`photo`	string	Non	URL de la photo
`company`	string	Non	Entreprise
`role`	string	Non	Rôle
`isFeatured`	boolean	Non	Mis en avant
`productId`	string	Non	ID du produit

Réponse


{
  "success": true,
  "data": {
    "id": "testimony_id",
    "name": "Jean Dupont",
    "comment": "Excellent service !",
    "rating": 5,
    "status": "APPROVED"
  }
}

`list`

Liste les témoignages avec filtres et pagination.

Exemple


const response = await client.testimony.list({
  appId: "app_id",
  apiKey: "user_api_key",
  status: "APPROVED",
  page: 1,
  limit: 20
});

`getById`

Récupère un témoignage par son ID.

Exemple


const response = await client.testimony.getById({
  appId: "app_id",
  apiKey: "user_api_key",
  id: "testimony_id"
});

`update`

Met à jour un témoignage.

Exemple


const response = await client.testimony.update({
  appId: "app_id",
  apiKey: "user_api_key",
  id: "testimony_id",
  rating: 4,
  isFeatured: true
});

`delete`

Supprime un témoignage.

Exemple


const response = await client.testimony.delete({
  appId: "app_id",
  apiKey: "user_api_key",
  id: "testimony_id"
});

`updateStatus`

Approuve ou rejette un témoignage.

Exemple


const response = await client.testimony.updateStatus({
  appId: "app_id",
  apiKey: "user_api_key",
  id: "testimony_id",
  status: "APPROVED"
});

`submit`

Permet à un client de soumettre un témoignage.

Exemple


const response = await client.testimony.submit({
  appId: "app_id",
  appApiKey: "app_api_key",
  customerApiKey: "customer_api_key",
  name: "Marie Martin",
  comment: "Super expérience !",
  rating: 5
});

`listPublic`

Liste les témoignages approuvés (endpoint public).

Exemple


const response = await client.testimony.listPublic({
  appId: "app_id",
  appApiKey: "app_api_key",
  isFeatured: true,
  limit: 10
});