API

L'API GoodRevyu

Intégrez la génération de réponses et la gestion des avis directement dans vos outils.

Une API REST propre, versionnée et documentée. Authentifiez-vous par clé API, générez des réponses, récupérez vos avis, recevez des webhooks signés à chaque événement.

Ce que vous pouvez faire

Générer une réponse

Envoyez le texte d'un avis, recevez une réponse rédigée par l'IA, modérée et prête à publier.

Lister et répondre aux avis

Récupérez vos avis, déclenchez une réponse, publiez sur la plateforme d'origine.

Suivre votre usage

Consultez votre consommation de réponses IA et d'appels API en temps réel.

Recevoir des webhooks

Soyez notifié à chaque nouvel avis ou réponse envoyée, avec une signature HMAC vérifiable.

Exemple : générer une réponse

Authentification

Chaque requête porte votre clé API dans l'en-tête Authorization. Les clés ont des portées (scopes) limitées et ne sont montrées qu'une fois.

L'API est incluse dans les forfaits Pro et Agence.

request

curl -X POST https://app.goodrevyu.com/api/v1/generate \
  -H "Authorization: Bearer rw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Super accueil, je reviendrai !",
    "rating": 5,
    "tone": "chaleureux"
  }'

200 OK

{
  "data": {
    "reply": "Merci beaucoup pour votre visite ! Au plaisir de vous revoir très bientôt.",
    "lang": "fr",
    "sentiment": "positive",
    "safe": true,
    "model": "claude-sonnet-4-6"
  }
}

Points d'accès principaux

GET /api/v1/reviews Lister vos avis

POST /api/v1/reviews/:id/reply Générer (et publier) une réponse

POST /api/v1/generate Générer une réponse à partir d'un texte

GET /api/v1/usage Consulter votre usage