Aperçu de l'API REST v2

FeedbackPulse SaaS fournit une API RESTful (v2) pour l'accès programmatique à vos données de locataire. Utilisez-la pour intégrer le feedback dans vos propres applications, créer des tableaux de bord ou automatiser des flux de travail.

---

URL de base

https://yourdomain.com/api/v2

---

Authentification

Toutes les requêtes API nécessitent un token Bearer (clé API) :

curl -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     https://yourdomain.com/api/v2/submissions

Obtenir une clé API

1. Connectez-vous à votre tableau de bord locataire
2. Allez à Paramètres > Clés API
3. Cliquez sur Créer une clé API
4. Copiez la clé immédiatement (elle n'est affichée qu'une seule fois !)

Les clés API sont stockées sous forme de hachages SHA256. La clé brute ne peut pas être récupérée.

Exigence de plan : L'accès à l'API nécessite l'indicateur de fonctionnalité api_access sur votre plan.

---

Limitation de débit

Limite	Valeur
Requêtes par minute par locataire	60

Les en-têtes de limite de débit sont inclus dans chaque réponse :

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 57

---

Points de terminaison disponibles

Méthode	Point de terminaison	Description
GET	/api/v2/submissions	Lister les soumissions
GET	/api/v2/submissions/{id}	Obtenir une soumission
POST	/api/v2/submissions	Créer une soumission
GET	/api/v2/products	Lister les produits
POST	/api/v2/products	Créer un produit
GET	/api/v2/campaigns	Lister les campagnes
POST	/api/v2/campaigns	Créer une campagne
GET	/api/v2/webhooks/config	Obtenir la configuration webhook
PUT	/api/v2/webhooks/config	Mettre à jour la configuration webhook
GET	/api/v2/webhooks/logs	Voir les journaux de livraison webhook

---

Format de réponse

Toutes les réponses sont en JSON :

{
  "data": [...],
  "meta": {
    "current_page": 1,
    "per_page": 15,
    "total": 42
  }
}

Réponses d'erreur

{
  "error": "Unauthenticated.",
  "status": 401
}

Code de statut	Signification
200	Succès
201	Créé
400	Requête invalide (erreur de validation)
401	Non autorisé (clé API invalide/manquante)
403	Interdit (permissions insuffisantes)
404	Non trouvé
429	Trop de requêtes (limitation de débit)
500	Erreur serveur

---

Pour aller plus loin

• Authentification — détails des clés API
• API Soumissions — créer et lister les feedbacks
• API Produits — gérer les produits
• API Campagnes — gérer les campagnes
• Webhooks — notifications d'événements en temps réel