Configurer votre clé API App Store Connect pour Appstead

Créez la clé API avec Sales and Reports, téléchargez le fichier .p8 une fois et ajoutez les identifiants qu'Appstead exige pour un workspace live.

Un workspace live dans Appstead se connecte directement à App Store Connect. Vous donnez à Appstead une clé API avec le rôle Sales and Reports, et l'app l'utilise pour lire vos données d'app et rapports de ventes. Aucun compte Appstead ni serveur n'est impliqué.

Les workspaces live font partie d'Appstead Pro. Si vous voulez essayer l'app avant de connecter un compte, le workspace démo intégré n'a besoin d'aucune clé.

Ce dont vous avez besoin

Appstead demande quatre éléments lors de l'ajout d'un workspace live :

• Une Issuer ID App Store Connect
• Une Key ID API
• Le fichier de clé privée .p8
• Votre Vendor Number pour les rapports de ventes

Avant de commencer

Vous avez besoin d'un compte Admin dans App Store Connect pour générer des Team Keys. Si vous vous connectez avec le rôle Developer ou App Manager, le bouton Generate n'apparaît pas. Demandez à l'Admin ou Account Holder de votre équipe de créer la clé, ou de vous promouvoir Admin.

La clé doit être un Team Key, pas un Individual Key. Apple n'autorise pas les Individual Keys à accéder aux données Sales and Finance, donc la validation d'un Individual Key échouera dans Appstead.

Créez une nouvelle clé pour Appstead plutôt que de réutiliser une clé d'un autre outil. La clé a besoin du rôle Sales and Reports. C'est le niveau d'accès qu'Appstead utilise pour configurer le workspace live.

Apple ne vous laisse télécharger le fichier privé .p8 qu'une seule fois. Gardez-le privé et prêt jusqu'à l'import. Ne le mettez jamais dans un dépôt de code et ne l'envoyez pas par e-mail ou chat.

1. Créer la clé API

1. Connectez-vous à App Store Connect et ouvrez API Keys. Si vous naviguez à la main : sous Users and Access, onglet Integrations, App Store Connect API.
2. Assurez-vous que l'onglet Team Keys est sélectionné et choisissez Generate API Key ou le bouton Add (+).
3. Nommez la clé Appstead ou un autre nom reconnaissable.
4. Sous Access, choisissez Sales and Reports.
5. Choisissez Generate.

Le guide des clés API d'Apple décrit le flux et les rôles actuels en détail.

2. Copier les ID et télécharger le fichier .p8

Sur la page Team Keys, réunissez ces trois éléments :

• Issuer ID : l'ID à l'échelle du compte en haut de la page. Il est identique pour chaque clé du compte.
• Key ID : l'ID dans la ligne de cette nouvelle clé.
• Private Key : choisissez Download API Key sur cette ligne pour enregistrer le fichier .p8.

Key ID et fichier .p8 doivent appartenir à la même clé API. Le lien de téléchargement disparaît une fois utilisé. S'il n'est plus là, créez une clé de remplacement. Apple ne conserve pas d'autre copie du fichier privé.

3. Trouver la Vendor Number

Appstead utilise votre Vendor Number pour demander les rapports de ventes. Ouvrez Payments and Financial Reports dans App Store Connect. Le numéro apparaît comme Vendor # en haut à gauche. C'est un numéro à l'échelle du compte, pas l'Apple ID d'une app.

4. Ajouter un workspace live dans Appstead

1. Ouvrez Appstead, allez dans Settings et choisissez Add Workspace. Si vous n'avez pas encore de workspace, l'écran vide propose Add Live Workspace, et l'Overview démo propose Connect App Store. Les trois ouvrent le même formulaire.
2. Si vous n'êtes pas encore sur Appstead Pro, l'écran Pro apparaît d'abord. Le formulaire s'ouvre une fois Pro actif.
3. Donnez au workspace un nom reconnaissable, par exemple le nom de votre studio.
4. Collez Issuer ID et Key ID.
5. Choisissez Choose .p8 File et sélectionnez la clé privée téléchargée.
6. Saisissez la Vendor Number.
7. Choisissez Validate & Save. Appstead vérifie les identifiants auprès d'Apple avant toute sauvegarde ou import.

Si vous avez déjà configuré ce workspace sur un autre appareil avec le même compte iCloud, Appstead peut trouver les identifiants dans iCloud Keychain et proposer de continuer avec eux.

Ce qui se passe après la connexion

• Le premier import charge les 90 derniers jours de rapports de ventes quotidiens pour remplir Overview et Trends tout de suite. Vous pouvez continuer à utiliser l'app pendant l'import.
• Les mises à jour ultérieures étendent l'historique jusqu'à l'année glissante de rapports quotidiens fournie par Apple.
• Apple publie en général le rapport d'hier vers 7 h heure du Pacifique. Jusque-là, le jour le plus récent manque, ce n'est pas zéro.
• Les cinq derniers jours sont récupérés à chaque actualisation et affichés comme provisoires car Apple peut encore les corriger.

Plus d'un compte App Store Connect

Chaque workspace Appstead garde les identifiants d'un compte. Pour un second compte, par exemple un client ou une ancienne équipe, répétez ces étapes avec une clé sous ce compte et ajoutez-le comme workspace distinct. Basculez entre workspaces d'un tap.

Si le téléchargement .p8 échoue sur iPhone ou iPad

Le téléchargement Apple peut échouer sur iPhone ou iPad. Téléchargez le fichier sur un Mac, transférez-le avec AirDrop ou Fichiers et importez-le dans Appstead. Supprimez les copies temporaires une fois l'import réussi.

Si Appstead ne peut pas valider la clé

Si Apple rejette les identifiants, vérifiez dans l'ordre :

• Issuer ID et Key ID n'ont pas d'espaces en trop.
• Le fichier .p8 choisi correspond à cette Key ID.
• La clé est un Team Key avec le rôle Sales and Reports et n'est pas révoquée.
• La Vendor Number appartient au compte App Store Connect que vous ajoutez.

Si Appstead indique que les identifiants fonctionnent mais qu'un accord manque, App Store Connect a accepté la clé mais votre Account Holder doit encore accepter un accord requis avant la livraison des rapports de ventes. Acceptez-le sur la page Agreements dans App Store Connect et réessayez.

Retirer un workspace ou révoquer la clé

Pour déconnecter, ouvrez le workspace dans Settings et choisissez Remove Workspace. Vous pouvez le retirer uniquement de cet appareil, le laissant sur les autres, ou de tous les appareils.

Retirer un workspace ne révoque pas la clé chez Apple. Si le fichier .p8 a été exposé ou que vous n'en avez plus besoin, révoquez la clé sur la page Team Keys dans App Store Connect. Une clé révoquée ne fonctionne plus dans Appstead immédiatement. Créez-en une nouvelle avant de révoquer si vous voulez garder le workspace.

Votre clé reste privée

Appstead conserve la clé privée de ce workspace dans Keychain. L'app n'envoie pas votre clé API, données de ventes ou métriques métier à un serveur Appstead.