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

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"}}}}}

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

Guides associés

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.