Tutoriel
Créer une clé API App Store Connect pour gérer les prix
Tout outil qui modifie vos prix à votre place — votre propre script ou RepriceCat — s’authentifie avec une clé API App Store Connect. Voici comment en créer une qui peut faire le travail, et rien de plus que le travail.
La réponse courte
Dans App Store Connect, allez dans Utilisateurs et accès → Intégrations → API App Store Connect → Clés d’équipe et générez une clé avec le rôle App Manager (ou Admin si vous voulez aussi les rapports de ventes). Téléchargez le fichier .p8 — vous n’avez qu’une seule occasion — et copiez le Key ID et l’Issuer ID. Ces trois valeurs constituent l’identifiant.
Créer la clé, pas à pas
Les étapes d’Apple (Apple : créer des clés API) nécessitent un compte Admin ; si l’API n’a jamais été utilisée dans votre équipe, le titulaire du compte doit d’abord en demander l’accès.
- Connectez-vous à App Store Connect, ouvrez Utilisateurs et accès et sélectionnez l’onglet Intégrations.
- Sélectionnez API App Store Connect dans la colonne de gauche et assurez-vous que l’onglet Clés d’équipe est sélectionné.
- Cliquez sur Générer une clé API, ou sur le bouton d’ajout (+).
- Saisissez un nom que vous reconnaîtrez plus tard, par exemple « Prix — RepriceCat ». Le nom ne sert que de repère pour vous.
- Sous Accès, choisissez le rôle (voir le tableau ci-dessous), puis cliquez sur Générer.
- Cliquez sur Télécharger la clé API à côté de la nouvelle clé. La clé privée se télécharge une seule fois sous forme de fichier .p8, en général nommé comme
AuthKey_2X9R4HXF34.p8; Apple n’en garde pas de copie et le lien disparaît après le téléchargement. - Copiez le Key ID dans la liste des clés actives, et l’Issuer ID affiché en haut de la page.
| Valeur | À quoi elle ressemble | Où la trouver |
|---|---|---|
| Issuer ID | Un UUID, par ex. 57246542-96fe-1a63-e053-0824d011072a | En haut de la page API App Store Connect ; identique pour toutes les clés d’équipe |
| Key ID | 10 caractères, par ex. 2X9R4HXF34 | À côté de la clé dans la liste des clés actives |
| Clé privée | Un fichier texte .p8 commençant par -----BEGIN PRIVATE KEY----- | Votre téléchargement ; impossible de le télécharger à nouveau |
Les exemples sont les valeurs d’exemple d’Apple, tirées de sa documentation sur les jetons.
Quel rôle donner à la clé ?
Le rôle d’une clé d’équipe détermine ce qu’elle peut faire, et les clés d’équipe accèdent à toutes les apps quel que soit le rôle. Les pages d’aide d’Apple sur la tarification indiquent Titulaire du compte, Admin ou App Manager comme rôle requis pour modifier les prix des apps, des achats intégrés et des abonnements (Apple : définir un prix, Apple : autorisations par rôle).
| Rôle | Peut modifier les prix | Rapports Ventes et tendances | À utiliser pour les prix ? |
|---|---|---|---|
| App Manager | Oui | Non décrit par Apple pour ce rôle | Oui — le plus petit rôle qui gère les prix |
| Admin | Oui | Oui | Oui, si la même clé doit aussi lire les rapports de ventes |
| Finance | Non | Oui | Non — rapports uniquement |
| Sales | Non | Oui | Non — rapports uniquement |
| Developer, Marketing, Customer Support | Non | Non décrit par Apple | Non |
Les clés Admin sont puissantes — Apple précise qu’elles peuvent créer et supprimer des utilisateurs — donc utilisez App Manager sauf si vous avez besoin des données de ventes avec la même clé. La lecture des ventes par pays est traitée dans le guide du numéro de fournisseur et des rapports de ventes.
Clés d’équipe ou clés individuelles
App Store Connect propose les deux. Utilisez une clé d’équipe pour les prix :
- Les clés d’équipe ont un rôle explicite et survivent au départ de la personne qui les a créées.
- Les clés individuelles portent l’accès et les rôles d’un seul utilisateur et sont générées depuis son profil — uniquement si un Admin a accordé l’autorisation Générer des clés API individuelles.
- Les clés individuelles ne peuvent pas utiliser les points d’accès Ventes et Finance, le provisionnement ou notarytool : elles ne conviennent donc pas aux rapports de ventes.
Testez la clé avant de vous y fier
- Signez un JWT : en-tête
algES256etkid= Key ID ; charge utileiss= Issuer ID,iat= maintenant,exp= au plus 20 minutes plus tard,aud=appstoreconnect-v1. - Appelez
GET https://api.appstoreconnect.apple.com/v1/appsavec le jeton en en-tête Bearer. Une liste de vos apps signifie que la clé fonctionne. - Un 401 signifie généralement un Issuer ID ou un Key ID erroné, un jeton signé avec une autre clé, ou un jeton dont la durée de vie est trop longue ou déjà expirée (vérifiez votre horloge).
- Un 403 sur un appel de tarification signifie généralement que le rôle de la clé ne peut pas gérer les prix — utilisez une clé avec le rôle App Manager ou Admin.
Une fois qu’elle fonctionne, le guide de l’API de tarification détaille les points d’accès des paliers de prix et des calendriers.
La stocker en sécurité
- Traitez le fichier .p8 comme un mot de passe. Quiconque l’a, avec les deux identifiants, peut agir avec le rôle de la clé sur toutes les apps de l’équipe.
- Le conseil d’Apple : ne partagez pas les clés, ne les stockez pas dans un dépôt de code et ne les incluez pas dans du code côté client.
- Gardez une clé par usage. La clé de tarification n’a pas à être celle que votre CI utilise pour les envois ; chacune peut ainsi être révoquée sans casser l’autre.
- Si vous la collez dans un outil, vérifiez ce que l’outil en fait. RepriceCat chiffre la clé avec AES-256-GCM avant de la stocker, ne la renvoie jamais au navigateur et ne s’en sert que pour signer des jetons de courte durée pour votre propre compte.
Erreurs courantes
- Choisir Developer ou Marketing parce que cela « semble plus sûr ». La clé lit alors les données, mais chaque changement de prix échoue.
- Créer une clé individuelle depuis votre profil puis se demander pourquoi les rapports de ventes sont refusés — les clés individuelles ne peuvent pas utiliser les points d’accès Ventes et Finance.
- Confondre le Key ID et l’Issuer ID. Le Key ID est court et va dans l’en-tête du jeton sous
kid; l’Issuer ID est un long UUID et va dans la charge utile sousiss. - Signer des jetons valables plus de 20 minutes. Apple les rejette pour les points d’accès de tarification ; un long traitement doit signer un nouveau jeton périodiquement et réutiliser chacun jusqu’à son expiration.
- Valider le fichier .p8 dans un dépôt, même privé. Déplacez-le dans un coffre à secrets et révoquez la clé exposée.
- Partager une même clé entre vos envois CI, un script de tarification et un outil tiers. Quand vous la révoquez pour une raison, tout le reste casse aussi.
Vous hésitez entre écrire votre propre script de tarification avec cette clé et utiliser un outil ? RepriceCat contre les scripts d’API expose les compromis.
La révoquer
Révoquez une clé quand quelqu’un part, quand elle a pu fuiter ou quand vous cessez d’utiliser un outil. Un Admin peut révoquer les clés d’équipe depuis la liste des clés API dans Utilisateurs et accès (Apple : révoquer des clés API). La révocation est définitive : une clé révoquée ne peut pas être rétablie, tous les jetons signés avec elle cessent de fonctionner, et elle reste listée sous Révoquées pendant 30 jours. Si vous perdez le fichier .p8, révoquez la clé et générez-en une nouvelle.
Utiliser la clé avec RepriceCat
Connecter RepriceCat demande l’Issuer ID, le Key ID et le fichier .p8 d’une clé d’équipe avec le rôle App Manager ou Admin. Ensuite :
- La clé est chiffrée au repos et vous pouvez la révoquer à tout moment dans App Store Connect.
- Rien n’est envoyé à Apple tant que vous n’avez pas approuvé une revue de chaque produit et de chaque pays ; une simulation n’envoie rien.
- La page Ventes demande en plus votre numéro de fournisseur et une clé avec le rôle Admin, Finance ou Sales — une clé Admin couvre donc les prix et les ventes d’un coup.
Prêt ? Connectez une clé et modifiez les prix de votre première app — le premier mois est gratuit, puis 1 $ par app et par mois.
Questions fréquentes
Où trouver l’Issuer ID ?
Dans App Store Connect, sous Utilisateurs et accès, Intégrations, API App Store Connect. Il se trouve en haut de la page, avec un bouton Copier, et il est identique pour toutes les clés d’équipe du compte.
J’ai perdu le fichier .p8. Puis-je le télécharger à nouveau ?
Non. Apple ne permet de télécharger la clé privée qu’une seule fois et n’en garde pas de copie. Révoquez la clé et générez-en une nouvelle.
Quel rôle App Store Connect peut modifier les prix ?
Admin et App Manager, ainsi que le titulaire du compte. App Manager est le plus petit rôle qui gère les prix ; Developer, Marketing, Finance et Sales ne le peuvent pas.
Qui peut créer une clé API App Store Connect ?
Les clés d’équipe sont générées par quelqu’un ayant un compte Admin, une fois que le titulaire du compte a demandé l’accès à l’API pour l’équipe. Les clés individuelles sont générées depuis le profil d’un utilisateur si un Admin lui en a accordé l’autorisation.
Puis-je utiliser une clé API individuelle pour les prix ?
Cela fonctionne pour les prix si le rôle de l’utilisateur le permet, mais une clé d’équipe est un meilleur choix : elle a un rôle explicite et survit au départ de l’utilisateur. Les clés individuelles ne peuvent pas non plus accéder aux rapports Ventes et Finance.
Est-il sûr de confier ma clé API à un outil de tarification ?
Seulement si vous faites confiance à la façon dont il stocke la clé, car celle-ci peut faire tout ce que son rôle autorise. Utilisez une clé d’équipe dédiée avec le plus petit rôle qui fonctionne, et révoquez-la quand vous cessez d’utiliser l’outil.
Essayer
Fixez les prix de tous les territoires à partir d’un seul prix de base
Paliers, arrondi aux paliers de prix, un seul tableau de vérification, une seule confirmation — via l’API App Store Connect. Premier mois offert, puis 1 $ par app et par mois.