Lister les temoignages

Recuperez une liste paginee des temoignages de votre organisation. Prend en charge les options de filtrage et de tri.

Point de terminaison

GET /v1/testimonials

Ce point de terminaison requiert une authentification. Incluez votre token API dans l'en-tete Authorization :

Authorization: Bearer YOUR_API_TOKEN

Parametre	Type	Defaut	Description
`page`	number	1	Numero de page pour la pagination
`limit`	number	25	Nombre de temoignages par page (max 100)
`status`	string	all	Filtrer par statut : `pending`, `approved`, `rejected`, `all`
`type`	string	all	Filtrer par type : `text`, `video`, `audio`, `all`
`rating`	number	-	Filtrer par note minimale (1-5)
`sort`	string	`createdAt`	Champ de tri : `createdAt`, `updatedAt`, `rating`
`order`	string	`desc`	Ordre de tri : `asc`, `desc`
`search`	string	-	Rechercher dans le contenu et le nom de l'auteur
`tags`	string	-	Liste de tags separes par des virgules

Retourne une liste paginee de temoignages :

Champ	Type	Description
`testimonials`	array	Tableau d'objets temoignage
`pagination`	object	Metadonnees de pagination
`pagination.page`	number	Numero de page courant
`pagination.limit`	number	Elements par page
`pagination.total`	number	Nombre total de temoignages
`pagination.totalPages`	number	Nombre total de pages
`pagination.hasNext`	boolean	Indique s'il existe une page suivante
`pagination.hasPrev`	boolean	Indique s'il existe une page precedente

Chaque temoignage dans la reponse contient :

Champ	Type	Description
`id`	string	Identifiant unique du temoignage
`content`	string	Contenu du temoignage
`author`	object	Informations sur l'auteur
`author.name`	string	Nom complet de l'auteur
`author.email`	string	Adresse email de l'auteur
`author.company`	string	Nom de l'entreprise de l'auteur (optionnel)
`rating`	number	Note de 1 a 5 etoiles (optionnel)
`type`	string	Type de temoignage : `text`, `video`, `audio`
`status`	string	Statut actuel : `pending`, `approved`, `rejected`
`tags`	array	Tableau de tags pour la categorisation
`createdAt`	string	Timestamp ISO 8601 de creation
`updatedAt`	string	Timestamp ISO 8601 de mise a jour

curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  "https://api.nowts.com/v1/testimonials?status=approved&type=video"

curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  "https://api.nowts.com/v1/testimonials?search=amazing%20product"

curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  "https://api.nowts.com/v1/testimonials?rating=4&sort=rating&order=desc"

Code	Description
`400`	Bad Request - Parametres de requete invalides
`401`	Unauthorized - Token API invalide ou manquant
`403`	Forbidden - Permissions insuffisantes
`500`	Internal Server Error - Un probleme est survenu chez nous