API App Store Connect
Modifier les prix avec l’API App Store Connect
Tout ce que font les écrans de tarification d’App Store Connect est disponible via l’API. Voici la carte : quelles ressources existent, à quoi ressemblent les requêtes, combien d’appels demande un changement mondial et ce qui se passe mal en pratique.
La réponse courte
Pour modifier un prix avec l’API App Store Connect, récupérez les paliers de prix du produit pour votre territoire de référence, choisissez le palier du nouveau prix, puis créez un calendrier de prix : POST /v1/appPriceSchedules pour les apps, POST /v1/inAppPurchasePriceSchedules pour les achats intégrés, ou un POST /v1/subscriptionPrices par territoire pour les abonnements. Authentifiez-vous avec un JWT signé par une clé API d’équipe.
Authentification
Chaque requête porte un JWT en en-tête Bearer que vous signez avec la clé privée .p8 de votre clé API (Apple : génération des jetons) :
- En-tête :
alg=ES256,kid= votre Key ID,typ=JWT. - Charge utile :
iss= votre Issuer ID,iat= maintenant,exp= au plus 20 minutes plus tard,aud=appstoreconnect-v1. Unscopefacultatif peut limiter un jeton à une liste de requêtes GET. - Réutilisez un même jeton pour de nombreuses requêtes jusqu’à son expiration ; Apple le recommande pour les performances. Les longs traitements en génèrent un nouveau périodiquement.
- La clé doit avoir un rôle capable de gérer les prix : Admin ou App Manager (les pages d’aide d’Apple indiquent Titulaire du compte, Admin ou App Manager comme rôle requis). La création d’une clé est expliquée dans le guide de la clé API.
Les ressources
| Produit | Paliers de prix | Égalisations | Créer un changement de prix |
|---|---|---|---|
| App | `GET /v1/apps/{id}/appPricePoints`?filter[territory]=USA | `GET /v3/appPricePoints/{id}/equalizations` | `POST /v1/appPriceSchedules` — territoire de référence plus prix manuels |
| Achat intégré | `GET /v2/inAppPurchases/{id}/pricePoints` | `GET /v1/inAppPurchasePricePoints/{id}/equalizations` | `POST /v1/inAppPurchasePriceSchedules` — territoire de référence obligatoire |
| Abonnement | `GET /v1/subscriptions/{id}/pricePoints` — toujours avec filter[territory] | `GET /v1/subscriptionPricePoints/{id}/equalizations` | `POST /v1/subscriptionPrices` — un par territoire |
| Territoires | `GET /v1/territories` | — | Lecture seule : les 175 vitrines et leurs devises |
Chaque palier de prix a un customerPrice et vos proceeds. Les égalisations d’un palier sont les paliers correspondants dans toutes les autres vitrines — les prix mondiaux d’Apple pour ce prix de référence, sans aucun calcul de taux de change de votre côté. Pour les abonnements avec des types de formule mensuelle et à paiement anticipé, Apple documente aussi adjustedEqualizations (Apple : configurer les prix des abonnements entre territoires). Lisez l’état actuel avec GET /v1/apps/{id}/appPriceSchedule et, pour les abonnements, GET /v1/subscriptions/{id}/prices.
À quoi ressemblent les requêtes
Un calendrier de prix d’app est un seul document JSON:API avec des prix créés en ligne. Les éléments qui comptent :
| Où | Champ | Valeur |
|---|---|---|
data | type | appPriceSchedules |
data.relationships | app | L’ID de votre app |
data.relationships | baseTerritory | Par exemple USA |
data.relationships | manualPrices | Références aux prix dans included, avec des ID temporaires comme ${price-1} |
included[] | type | appPrices (achats intégrés : inAppPurchasePrices) |
included[].attributes | startDate, endDate | null pour « maintenant » et « sans fin », ou une date |
included[].relationships | appPricePoint | L’ID du palier de prix pour ce territoire |
Les territoires sans prix manuel reçoivent le prix automatique d’Apple dérivé de la référence. Un prix d’abonnement est plus simple : type subscriptionPrices, attributs startDate et preserveCurrentPrice (plus planType si vous proposez des types de formule), et des relations vers l’abonnement, le territoire et le subscriptionPricePoint.
Un changement mondial, pas à pas
- Listez les territoires une fois et mettez-les en cache ; ils changent rarement.
- Pour chaque produit, récupérez les paliers de prix de votre territoire de référence (200 par page) et trouvez celui qui correspond à votre nouveau prix de référence.
- Pour les prix d’Apple partout, arrêtez-vous là : le palier de référence suffit pour les apps et les achats intégrés. Pour vos propres prix régionaux, calculez une cible par vitrine et arrondissez-la — le plus simple est d’arrondir la cible dans la devise de référence et de suivre les égalisations de ce palier (comment fonctionne l’arrondi).
- Apps et achats intégrés : envoyez un seul calendrier en POST avec le territoire de référence et tous les prix manuels. Abonnements : envoyez en POST un
subscriptionPricespar vitrine, avec la date de début et la politique pour les abonnés existants. - Gérez les 429 et 5xx avec un délai croissant et une nouvelle tentative ; journalisez chaque ressource créée comme piste d’audit.
- Relisez le calendrier ou les prix et vérifiez quelques vitrines dans App Store Connect.
Combien de requêtes faut-il ?
Un exemple chiffré : 2 apps, 10 achats intégrés et 4 abonnements, retarifés avec 4 paliers régionaux. L’exemple de limite de débit d’Apple indique 3 500 requêtes par heure glissante et par clé, et précise que les limites réelles varient — lisez l’en-tête X-Rate-Limit de chaque réponse (Apple : limites de débit).
| Étape | Calcul | Requêtes |
|---|---|---|
| Territoires | Une fois | 1 |
| Paliers de prix de référence | 16 produits × environ 5 pages | ≈ 80 |
| Égalisations | 16 produits × 4 paliers | ≈ 64 |
| Calendriers d’apps et d’achats intégrés | 12 produits × 1 | 12 |
| Prix des abonnements | 4 abonnements × 175 vitrines | 700 |
| Total | ≈ 857 |
Les abonnements dominent : Apple précise qu’il n’existe pas de point d’accès en masse pour appliquer des prix d’abonnement égalisés. Doublez le catalogue, ajoutez les nouvelles tentatives et une passe de vérification, et vous approchez de la limite horaire de l’exemple — rythmez donc le traitement plutôt que de lancer une boucle serrée.
Pièges
- Un POST de calendrier remplace tout le calendrier de l’app ou de l’achat intégré. Incluez tous les prix manuels que vous voulez garder, pas seulement ceux qui changent — tout ce qui est omis retombe sur le prix automatique d’Apple.
- Pour planifier un changement futur sur une app ou un achat intégré, envoyez les prix manuels d’aujourd’hui avec un
endDateégal au nouveaustartDate, puis les nouveaux prix. Deux intervalles adjacents au même palier de prix sont rejetés (« Adjacent intervals cannot have the same price point »), envoyez donc un territoire inchangé comme une seule entrée sans fin. - Les abonnements ne gardent qu’un prix futur au plus par territoire. Supprimez celui en attente avec `DELETE /v1/subscriptionPrices/{id}` avant d’en créer un autre.
- Un prix d’abonnement sans date de début est le prix initial. Une fois l’abonnement approuvé, les prix suivants exigent un
startDate; sinon l’API répond par une erreur d’état 409. - Les baisses de prix d’abonnement s’appliquent aux abonnés existants, et tout changement d’abonnement ne peut plus être annulé une fois en vigueur. Les hausses peuvent exiger un consentement — voir augmenter le prix d’un abonnement.
- Les listes de paliers de prix sont volumineuses. Filtrez toujours par territoire et paginez.
- Les jetons durent au plus 20 minutes pour ces points d’accès ; les longs traitements doivent re-signer.
- Les changements peuvent mettre jusqu’à une heure à apparaître dans le sandbox.
- Rien dans l’API ne demande « êtes-vous sûr ? ». Construisez vous-même l’étape de revue.
Tester un script de tarification en toute sécurité
Il n’existe pas de copie de préproduction de votre compte App Store Connect : intégrez donc la sécurité au script lui-même :
- Donnez au script une option de simulation qui calcule tout et affiche un tableau produit, territoire, prix actuel et nouveau prix — sans rien envoyer.
- Avant d’écrire, lisez le calendrier ou les prix en vigueur et comparez-les à votre plan ; ignorez les territoires qui ont déjà le prix cible.
- Faites la première vraie écriture sur un produit qui n’est pas encore en vente, ou sur un seul territoire, et relisez le résultat.
- Écrivez une ligne de journal par territoire avec l’ancien et le nouveau palier de prix. Si quelque chose tourne mal, ce journal sert à remettre les prix en place.
- Gardez la clé dans un coffre à secrets, jamais dans le dépôt, et donnez au script sa propre clé pour pouvoir la révoquer indépendamment.
Se passer du script : RepriceCat
RepriceCat est, en somme, ce guide devenu produit. Vous connectez votre propre clé d’équipe (stockée chiffrée, révocable à tout moment), et il récupère les paliers de prix, arrondit les prix des paliers régionaux à des paliers valides, construit les calendriers — y compris le report des prix actuels pour les changements planifiés — et se cadence selon la limite de débit.
- Un tableau de revue produit × pays, prix actuel → nouveau prix, avant tout envoi ; une simulation qui n’envoie rien.
- Jusqu’à 200 produits répartis sur plusieurs apps en un seul changement, tout de suite ou à une date donnée.
- Les pays en échec listés avec la raison donnée par Apple et renvoyables seuls ; chaque changement journalisé par pays, avec annulation.
- Aller-retour par tableur : exportez les prix en XLSX ou CSV, modifiez, réimportez.
Vous hésitez entre développer et acheter ? Lisez RepriceCat contre les scripts d’API, ou commencez avec un mois gratuit.
Questions fréquentes
De quel rôle une clé API App Store Connect a-t-elle besoin pour modifier les prix ?
Admin ou App Manager. Les pages d’aide d’Apple sur la tarification indiquent Titulaire du compte, Admin ou App Manager comme rôles pouvant gérer les prix ; les clés avec les rôles Developer, Marketing, Sales ou Finance ne le peuvent pas.
L’API peut-elle modifier les prix de tous les territoires en une seule requête ?
Pour les apps et les achats intégrés, oui : un calendrier de prix porte le territoire de référence et tous les prix manuels. Pour les abonnements, chaque territoire est sa propre ressource subscriptionPrices, donc un changement mondial représente jusqu’à 175 requêtes par abonnement.
Comment obtenir les prix égalisés d’Apple via l’API ?
Trouvez le palier de prix de votre prix de référence, puis appelez son point d’accès equalizations. Il renvoie le palier comparable dans chaque autre vitrine, que vous pouvez utiliser tel quel ou comme prix arrondi pour un palier régional.
Existe-t-il un sandbox ou un mode simulation pour les appels de tarification ?
Non. Les calendriers de prix agissent sur le vrai compte. Vérifiez soigneusement le lot calculé, testez sur un produit pas encore en ligne, ou utilisez un outil doté de sa propre simulation.
Quelle est la limite de débit de l’API App Store Connect ?
Les limites s’appliquent par clé API sur une heure glissante et sont indiquées dans l’en-tête X-Rate-Limit de chaque réponse. L’exemple d’Apple montre 3 500 requêtes par heure mais précise que les limites réelles varient ; un dépassement renvoie HTTP 429.
Comment annuler un changement de prix planifié via l’API ?
Pour un abonnement, supprimez la ressource subscriptionPrices en attente. Pour une app ou un achat intégré, envoyez en POST un nouveau calendrier sans l’entrée future, en vous rappelant que le POST remplace tout le calendrier.
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.