API App Store Connect : lire les avis clients et y répondre
English · Español · Deutsch · Polski
L’API App Store Connect expose les avis clients de vos apps et vous permet de créer, modifier et supprimer des réponses. Les endpoints et paramètres ci-dessous proviennent de la documentation de l’API d’Apple.
Authentification
Les requêtes utilisent un JSON Web Token signé avec une clé d’API App Store Connect (App Store Connect API: Generating tokens for API requests).
Lister les avis
GET https://api.appstoreconnect.apple.com/v1/apps/{id}/customerReviews?filter[rating]=1,2&filter[territory]=USA&exists[publishedResponse]=false&sort=-createdDate&limit=200&include=response
- Filtres :
filter[rating],filter[territory],exists[publishedResponse](pour trouver les avis sans réponse). - Tri :
rating,-rating,createdDate,-createdDate.limitjusqu’à 200. - Attributs :
rating,title,body,reviewerNickname,createdDate,territory. - Par version :
GET /v1/appStoreVersions/{id}/customerReviews.
Sources : App Store Connect API: List all customer reviews for an app ; App Store Connect API: Customer Reviews.
Répondre
POST https://api.appstoreconnect.apple.com/v1/customerReviewResponses
Content-Type: application/json
{"data": {"type": "customerReviewResponses",
"attributes": {"responseBody": "Thanks, Sam. 4.2.1 fixes the sync bug."},
"relationships": {"review": {"data": {"type": "customerReviews", "id": "REVIEW_ID"}}}}}
- Un avis ne peut avoir qu’une seule réponse. S’il en existe déjà une, cette requête la remplace (App Store Connect API: Create or update a response to a customer review).
- Les réponses n’apparaissent pas instantanément. Le champ
statede la réponse vautPENDING_PUBLISHouPUBLISHED(App Store Connect API: Customer Review Responses). - Lisez-la avec
GET /v1/customerReviews/{id}/response; supprimez-la avecDELETE /v1/customerReviewResponses/{id}(App Store Connect API: Customer Review Responses).
Les règles s’appliquent toujours
Les réponses envoyées via l’API suivent les mêmes règles que dans App Store Connect : respect, aucune information personnelle, ni spam ni marketing (directive 5.6.1, App Store Review Guidelines (5.6.1, 5.6.3, 5.6.4)). L’auteur de l’avis est notifié et peut modifier son avis (Apple Developer: Ratings, reviews, and responses).
Sources
- App Store Connect API: Generating tokens for API requests
- App Store Connect API: List all customer reviews for an app
- App Store Connect API: Customer Reviews
- App Store Connect API: Create or update a response to a customer review
- App Store Connect API: Customer Review Responses
- App Store Review Guidelines (5.6.1, 5.6.3, 5.6.4)
- Apple Developer: Ratings, reviews, and responses
Guides associés
- Comment répondre aux avis App Store : les règles d’Apple
- API Google Play pour répondre aux avis : lister et répondre
- Comment analyser les avis de votre application pour votre feuille de route produit
- Tous les guides pour développeurs
Questions fréquentes
Comment trouver les avis App Store sans réponse avec l’API ?
Listez les avis clients avec exists[publishedResponse]=false.
Un avis App Store peut-il avoir plusieurs réponses ?
Non. Un avis ne peut avoir qu’une seule réponse ; en publier une nouvelle remplace la précédente.
Combien d’avis puis-je récupérer par requête ?
Le paramètre limit accepte jusqu’à 200 sur l’endpoint de liste.
Pourquoi ma réponse n’apparaît-elle pas encore ?
Apple indique que les réponses n’apparaissent pas instantanément ; l’état reste PENDING_PUBLISH jusqu’à la publication.