Connecter App Store Connect

Mis à jour le

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

Pré-requis Détail
Rôle dans App Store Connect App Manager (minimum) sur l’app
Bundle ID déjà renseigné côté onglet Général de l’app dans StatHall (ex : com.acme.myapp)
Vendor Number facultatif, uniquement si l’app génère des revenus

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 :

Champ Valeur
Key ID étape 2
Issuer ID étape 2
Fichier .p8 sélectionner le fichier téléchargé en étape 1
Vendor number étape 3 (laissez vide pour une app gratuite)

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

Dépannage

Erreur Cause probable Action
401 AuthenticationError Key ID ou .p8 corrompu (BOM, CRLF, lignes ajoutées) Régénérer la clé. Ne pas éditer le .p8.
403 USER_NOT_ASSIGNED Clé non rattachée à l’app Régénérer avec rôle App Manager + sélection explicite de l’app
403 Vendor Vendor number obsolète Re-vérifier dans Sales and Trends
Rate limit (~20 req/s) Backfill historique en cours Laisser tourner — StatHall tampon par paquets