---
title: "Connecter App Store Connect"
description: "Avis, versions et ventes de vos applications iOS."
lang: fr
canonical: "https://www.stathall.com/docs/connecteur-apple/"
updated: "2026-09-16"
---

# 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

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