Lister les témoignages
Récupérez les témoignages de votre organisation.
Récupère une liste paginée des témoignages de l’organisation, avec filtres et tri.
Point d’entrée
GET /v1/testimonialsAuthentification
Ce point d’entrée nécessite un jeton d’API dans l’en-tête Authorization :
Authorization: Bearer YOUR_API_TOKENParamètres de requête
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
page | number | 1 | Numéro de page |
limit | number | 25 | Témoignages par page, 100 maximum |
status | string | all | Statut : pending, approved, rejected, all |
type | string | all | Type : text, video, audio, all |
rating | number | - | Note minimale de 1 à 5 |
sort | string | createdAt | Champ de tri : createdAt, updatedAt, rating |
order | string | desc | Ordre : asc ou desc |
search | string | - | Recherche dans le contenu et le nom de l’auteur |
tags | string | - | Liste d’étiquettes séparées par des virgules |
Réponse
Renvoie une liste paginée :
| Champ | Type | Description |
|---|---|---|
testimonials | array | Tableau de témoignages |
pagination | object | Métadonnées de pagination |
pagination.page | number | Page courante |
pagination.limit | number | Éléments par page |
pagination.total | number | Nombre total de témoignages |
pagination.totalPages | number | Nombre total de pages |
pagination.hasNext | boolean | Présence d’une page suivante |
pagination.hasPrev | boolean | Présence d’une page précédente |
Objet témoignage
Chaque témoignage contient :
| Champ | Type | Description |
|---|---|---|
id | string | Identifiant unique |
content | string | Contenu |
author | object | Informations sur l’auteur |
author.name | string | Nom complet |
author.email | string | Adresse e-mail |
author.company | string | Entreprise facultative |
rating | number | Note facultative de 1 à 5 étoiles |
type | string | Type : text, video ou audio |
status | string | Statut : pending, approved ou rejected |
tags | array | Étiquettes de classement |
createdAt | string | Date de création ISO 8601 |
updatedAt | string | Date de dernière modification ISO 8601 |
Exemples
Témoignages vidéo approuvés
curl -H "Authorization: Bearer YOUR_API_TOKEN" \
"https://ndd-seo.fr/api/v1/testimonials?status=approved&type=video"Rechercher des témoignages
curl -H "Authorization: Bearer YOUR_API_TOKEN" \
"https://ndd-seo.fr/api/v1/testimonials?search=amazing%20product"Témoignages les mieux notés
curl -H "Authorization: Bearer YOUR_API_TOKEN" \
"https://ndd-seo.fr/api/v1/testimonials?rating=4&sort=rating&order=desc"Codes d’erreur
| Code | Description |
|---|---|
400 | Paramètres de requête non valides |
401 | Jeton d’API absent ou non valide |
403 | Autorisations insuffisantes |
500 | Erreur interne du serveur |