Connecter App Store Connect

StatHall lit en lecture seule les avis clients et les rapports financiers / téléchargements / crashs de votre app iOS via l’API App Store Connect. L’authentification se fait par clé .p8 (JWT signé), pas par login/mot de passe.

Aucune écriture vers le store. Aucune réponse aux reviews. La clé sert uniquement aux endpoints en lecture.

Avant de commencer

Pour une app gratuite, laissez le Vendor Number vide. Les ventes sont alors ignorées proprement, mais les avis, téléchargements et crashs restent synchronisés.

Étape 1 — Créer une clé API

Dans App Store Connect :

1. Ouvrez Users and Access → Integrations → Keys (onglet App Store Connect API).
2. Cliquez sur + pour générer une nouvelle clé.
3. Donnez un nom explicite, par ex. statsapps-readonly.
4. Sélectionnez le rôle App Manager (lecture des reviews + rapports).
5. Si votre organisation segmente les rôles par app, cochez explicitement l’app concernée.
6. Cliquez sur Generate, puis téléchargez le fichier .p8.

⚠️ Le fichier .p8 n’est téléchargeable qu’une seule fois. Stockez-le en lieu sûr immédiatement.

Étape 2 — Récupérer Key ID et Issuer ID

Toujours sur la même page :

• Key ID : colonne juste à côté du nom de la clé (10 caractères, ex : ABCDEF1234).
• Issuer ID : en haut de la page, sous forme d’UUID (ex : 12345678-1234-1234-1234-123456789abc). Commun à toutes les clés de l’organisation.

Étape 3 — (optionnel) Vendor Number

Pour les apps payantes :

1. Ouvrez Payments and Financial Reports → Reports → Sales and Trends.
2. Notez le numéro vendor dans l’en-tête (ex : 80123456).

Ce numéro change parfois lors d’un transfert d’ownership de l’app — pensez à le re-vérifier en cas d’erreur 403.

Étape 4 — Saisir dans StatHall

Dans l’app, ouvrez Sources → Apple et renseignez :

Cliquez sur Tester la connexion. StatHall appelle GET /v1/apps?filter[bundleId]=… pour valider la clé. Puis Enregistrer.

Dépannage