Documentation de l’API
France Avis parle le langage de l’ancien prestataire : un logiciel déjà branché continue de marcher en changeant seulement l’adresse et les identifiants.
Authentification
Créez un accès dans votre espace (Collecte, QR code, API) : un client_id et un secret, montré une seule fois. Échangez-les contre un jeton valable une heure :
curl -X POST https://france-avis.fr/oauth2/token -d grant_type=client_credentials -d client_id=fa_… -d client_secret=…
Puis appelez l’API avec le jeton dans l’en-tête Authorization :
curl https://france-avis.fr/api/v1/api-compat/published/brands/reviews?limit=50 -H "Authorization: Bearer …"
Points d’accès
Chaque point répond à son adresse France Avis et à l’adresse de l’ancien prestataire.
/oauth2/token/realms/skeepers/protocol/openid-connect/token
/api/v1/api-compat/published/products/verified-reviews/v1/published/products · portée apicompat.products:read
/api/v1/api-compat/published/products/ratings/verified-reviews/v1/published/products/ratings · portée apicompat.productratings:read
/api/v1/api-compat/published/products/reviews/verified-reviews/v1/published/products/reviews · portée apicompat.productreviews:read
/api/v1/api-compat/published/brands/reviews/verified-reviews/v1/published/brands/reviews · portée apicompat.brandreviews:read
/api/v1/api-compat/published/brands/verified-reviews/v1/published/brands · portée apicompat.brands:read
/api/v1/api-compat/purchase-events/{website_id}/bulk-sync-insert/purchase-event/websites/{website_id}/purchase_events/bulk_sync_insert · portée apicompat.purchaseevents:create
Les listes se lisent par curseur : la page suivante est dans l’en-tête Link (rel="next"). Les moyennes sont des chaînes décimales (« 4.50 »).
Webhooks
Déclarez une adresse dans votre espace : France Avis y poste chaque avis publié (review.published) ou signalé (review.reported), au format Standard Webhooks. Vérifiez la signature ainsi :
HMAC-SHA256(base64_decode(secret), webhook-id + "." + webhook-timestamp + "." + corps) → webhook-signature: v1,<base64>
Les anciens modules e-commerce
Les modules WooCommerce, Magento 2, PrestaShop, Thelia, Sylius… de l’ancien prestataire marchent avec l’ID site et la clé secrète de votre espace. WooCommerce et Magento 2 sont appelés par France Avis chaque heure, une fois branchés dans votre espace.
- POST
/index.php?action=act_api_notification_sha1&type=json2La notification de commande (signée par la clé des modules) - GET
/fr/cache/{c1}/{c2}/{c3}/{website_id}/AWS/…Les fichiers de notes et d’avis (infosite, all_products, reviews…) - GET
/v1/websites/{website_id}/products/ratingsL’ancienne Product Reviews API - POST
/productL’API Genesis (module Magento 2) - POST
/index.php?action=act_api_product_reviews_helpfulLe vote « utile » des blocs d’avis
Vous venez de Trustpilot
Votre intégration Trustpilot marche avec France Avis : remplacez ses deux adresses de base par celle de France Avis. Les chemins, les champs et les jetons restent les mêmes.
https://api.trustpilot.comhttps://france-avis.frhttps://invitations-api.trustpilot.comhttps://france-avis.frPrenez un jeton avec la clé et le secret d’un accès API de votre espace (Collecte, QR code, API) :
curl -X POST https://france-avis.fr/v1/oauth/oauth-business-users-for-applications/accesstoken -u "fa_…:secret" -d grant_type=client_credentials
Les routes publiques se lisent avec la clé publique, l’identifiant de l’accès (fa_…), dans l’en-tête apikey. Votre businessUnitId est l’identifiant de votre entreprise : find?name=votre-domaine le donne.
curl "https://france-avis.fr/v1/business-units/find?name=votre-domaine.fr" -H "apikey: fa_…"
/v1/oauth/oauth-business-users-for-applications/accesstoken/v1/oauth/oauth-business-users-for-applications/refresh/v1/oauth/oauth-business-users-for-applications/revoke/v1/private/business-units/{businessUnitId}/email-invitationstrustpilotcompat.invitationsemail:create /v1/private/business-units/{businessUnitId}/invitation-linkstrustpilotcompat.invitationslink:create /v1/private/product-reviews/business-units/{businessUnitId}/invitation-linkstrustpilotcompat.invitationsproductlink:create /v1/private/business-units/{businessUnitId}/templatestrustpilotcompat.invitationstemplates:read /v1/private/business-units/{businessUnitId}/invitation-data/deletetrustpilotcompat.invitationsdelete:delete /v1/business-units/find?name={domaine}/v1/business-units/{businessUnitId}/v1/business-units/{businessUnitId}/reviews/v1/business-units/{businessUnitId}/all-reviews/v1/business-units/{businessUnitId}/web-links/v1/reviews/{reviewId} · /v1/reviews/latest/v1/product-reviews/business-units/{businessUnitId}/reviews?sku={sku}/v1/product-reviews/business-units/{businessUnitId}?sku={sku}/v1/product-reviews/business-units/{businessUnitId}/batch-summaries/v1/private/product-reviews/business-units/{businessUnitId}/summariestrustpilotcompat.productreviewsprivatesummaries:read /v1/private/product-reviews/business-units/{businessUnitId}/reviewstrustpilotcompat.productreviewsprivatereviews:read /v1/private/product-reviews/{reviewId}trustpilotcompat.productreviewsprivatereview:read /v1/private/business-units/{businessUnitId}/reviewstrustpilotcompat.privatereviewslist:read /v1/private/reviews/{reviewId}trustpilotcompat.privatereviewsshow:read /v1/private/reviews/{reviewId}/replytrustpilotcompat.privatereviewsreply:create /v1/private/reviews/{reviewId}/replytrustpilotcompat.privatereviewsdeletereply:delete Ce qui diffère
- Une réponse envoyée par l’API est relue par la modération avant d’être publiée, comme toute réponse sur France Avis.
- Les codes HTTP sont ceux de Trustpilot ; le corps d’une erreur peut différer du leur.
Ce qui n’est pas pris en charge
- Les widgets TrustBox (un script servi par Trustpilot) : posez nos widgets à la place, rubrique Collecte.
- Le catalogue produits privé : vos produits arrivent avec vos invitations et vos commandes.
- Les catégories, les conversations et la connexion authorization_code.
Limites
200 éléments au plus par page, 50 commandes par appel, cinq accès API et cinq modules par entreprise. Les avis renvoyés sont les avis publiés ; l’adresse e-mail d’un client n’est renvoyée que par les routes privées compatibles Trustpilot, à votre seul jeton.