Guías prácticas
Crear una clave de API de App Store Connect para precios
Cualquier herramienta que cambie precios en tu nombre, ya sea tu propio script o RepriceCat, se autentica con una clave de API de App Store Connect. Aquí tienes cómo crear una que pueda hacer el trabajo, y nada más que el trabajo.
La respuesta corta
En App Store Connect, ve a Usuarios y acceso → Integraciones → API de App Store Connect → Claves de equipo y genera una clave con el rol App Manager (o Admin si también quieres informes de ventas). Descarga el archivo .p8 (solo tienes una oportunidad) y copia el Key ID y el Issuer ID. Esos tres valores son la credencial.
Crear la clave, paso a paso
Los pasos de Apple (Apple: crear claves de API) requieren una cuenta Admin; si la API nunca se ha usado en tu equipo, primero el titular de la cuenta tiene que solicitar acceso a ella.
- Inicia sesión en App Store Connect, abre Usuarios y acceso y selecciona la pestaña Integraciones.
- Selecciona API de App Store Connect en la columna izquierda y asegúrate de que está seleccionada la pestaña Claves de equipo.
- Haz clic en Generar clave de API o en el botón de añadir (+).
- Escribe un nombre que reconozcas más adelante, por ejemplo “Precios — RepriceCat”. El nombre es solo para tu referencia.
- En Acceso, elige el rol (consulta la tabla de abajo) y haz clic en Generar.
- Haz clic en Descargar clave de API junto a la nueva clave. La clave privada se descarga una sola vez como archivo .p8, normalmente con un nombre como
AuthKey_2X9R4HXF34.p8; Apple no guarda ninguna copia y el enlace desaparece después de descargarla. - Copia el Key ID de la lista de claves activas y el Issuer ID que aparece cerca de la parte superior de la página.
| Valor | Aspecto | Dónde encontrarlo |
|---|---|---|
| Issuer ID | Un UUID, p. ej. 57246542-96fe-1a63-e053-0824d011072a | Parte superior de la página de la API de App Store Connect; es el mismo para todas las claves de equipo |
| Key ID | 10 caracteres, p. ej. 2X9R4HXF34 | Junto a la clave en la lista de activas |
| Clave privada | Un archivo de texto .p8 que empieza por -----BEGIN PRIVATE KEY----- | Tu descarga; no se puede descargar de nuevo |
Los ejemplos son valores de muestra del propio Apple, de su documentación de tokens.
¿Qué rol debe tener la clave?
El rol de una clave de equipo decide lo que puede hacer, y las claves de equipo pueden acceder a todas las apps sea cual sea el rol. Las páginas de ayuda de precios de Apple indican titular de la cuenta, Admin o App Manager como el rol necesario para cambiar los precios de apps, compras dentro de la app y suscripciones (Apple: establecer un precio, Apple: permisos de los roles).
| Rol | Puede cambiar precios | Informes de Sales and Trends | ¿Sirve para precios? |
|---|---|---|---|
| App Manager | Sí | Apple no lo describe para este rol | Sí: el rol más pequeño que gestiona precios |
| Admin | Sí | Sí | Sí, si la misma clave también debe leer informes de ventas |
| Finance | No | Sí | No: solo informes |
| Sales | No | Sí | No: solo informes |
| Developer, Marketing, Customer Support | No | Apple no lo describe | No |
Las claves Admin son poderosas (Apple señala que pueden crear y eliminar usuarios), así que usa App Manager salvo que necesites los datos de ventas con la misma clave. Leer las ventas por país se explica en la guía del número de proveedor y los informes de ventas.
Claves de equipo frente a claves individuales
App Store Connect ofrece ambas. Usa una clave de equipo para los precios:
- Las claves de equipo tienen un rol explícito y sobreviven a que la persona que las creó deje el equipo.
- Las claves individuales llevan el acceso y los roles de un solo usuario y se generan desde el perfil de ese usuario, solo si un Admin le ha concedido el permiso de generar claves de API individuales.
- Las claves individuales no pueden usar los endpoints de Sales y Finance, el aprovisionamiento ni notarytool, así que no sirven para informes de ventas.
Prueba la clave antes de depender de ella
- Firma un JWT: cabecera
algES256ykid= Key ID; cargaiss= Issuer ID,iat= ahora,exp= no más de 20 minutos después,aud=appstoreconnect-v1. - Llama a
GET https://api.appstoreconnect.apple.com/v1/appscon el token en una cabecera bearer. Si obtienes una lista de tus apps, la clave funciona. - Un 401 suele significar un Issuer ID o un Key ID equivocado, un token firmado con otra clave o un token cuya vida es demasiado larga o ya ha caducado (revisa tu reloj).
- Un 403 en una llamada de precios suele significar que el rol de la clave no puede gestionar precios: usa una clave con el rol App Manager o Admin.
Cuando funcione, la guía de la API de precios recorre los endpoints de puntos de precio y calendarios.
Guardarla con seguridad
- Trata el .p8 como una contraseña. Cualquiera que lo tenga junto con los dos ID puede actuar con el rol de la clave en todas las apps del equipo.
- El consejo de Apple: no compartas las claves, no las guardes en un repositorio de código ni las incluyas en código del lado del cliente.
- Usa una clave por finalidad. Una clave de precios no tiene por qué ser la que usa tu CI para las subidas, así cada una se puede revocar sin romper la otra.
- Si la pegas en una herramienta, comprueba qué hace con ella. RepriceCat cifra la clave con AES-256-GCM antes de guardarla, nunca la devuelve al navegador y solo la usa para firmar tokens de corta duración para tu propia cuenta.
Errores habituales
- Elegir Developer o Marketing porque “suena más seguro”. Entonces la clave lee datos, pero todos los cambios de precio fallan.
- Crear una clave individual desde tu perfil y preguntarte después por qué se rechazan los informes de ventas: las claves individuales no pueden usar los endpoints de Sales y Finance.
- Confundir el Key ID con el Issuer ID. El Key ID es corto y va en la cabecera del token como
kid; el Issuer ID es un UUID largo y va en la carga comoiss. - Firmar tokens que duran más de 20 minutos. Apple los rechaza en los endpoints de precios; un trabajo largo debe firmar un token nuevo periódicamente y reutilizar cada uno hasta que caduque.
- Subir el archivo .p8 a un repositorio, aunque sea privado. Muévelo a un almacén de secretos y revoca la clave expuesta.
- Compartir una misma clave entre las subidas de tu CI, un script de precios y una herramienta de terceros. Cuando la revocas por un motivo, todo lo demás también se rompe.
¿Dudas entre escribir tu propio script de precios con esta clave o usar una herramienta? RepriceCat frente a scripts de API expone los pros y los contras.
Revocarla
Revoca una clave cuando alguien se va, cuando puede haberse filtrado o cuando dejas de usar una herramienta. Un Admin puede revocar las claves de equipo desde la lista de claves de API en Usuarios y acceso (Apple: revocar claves de API). La revocación es permanente: una clave revocada no se puede reactivar, todos los tokens firmados con ella dejan de funcionar y sigue apareciendo en Revocadas durante 30 días. Si pierdes el .p8, revoca la clave y genera una nueva.
Usar la clave con RepriceCat
Conectar RepriceCat requiere el Issuer ID, el Key ID y el archivo .p8 de una clave de equipo con el rol App Manager o Admin. A partir de ahí:
- La clave se cifra en reposo y puedes revocarla en cualquier momento en App Store Connect.
- No se envía nada a Apple hasta que apruebas una revisión de cada producto y país; una simulación no envía nada.
- La página Sales necesita además tu número de proveedor y una clave con el rol Admin, Finance o Sales, así que una clave Admin cubre precios y ventas a la vez.
¿Listo? Conecta una clave y cambia los precios de tu primera app: el primer mes es gratis y después cuesta $1 por app al mes.
Preguntas frecuentes
¿Dónde encuentro el Issuer ID?
En App Store Connect, en Usuarios y acceso, Integraciones, API de App Store Connect. Está cerca de la parte superior de la página, con un botón Copiar, y es el mismo para todas las claves de equipo de la cuenta.
He perdido el archivo .p8. ¿Puedo descargarlo otra vez?
No. Apple te deja descargar la clave privada una sola vez y no guarda ninguna copia. Revoca la clave y genera una nueva.
¿Qué rol de App Store Connect puede cambiar precios?
Admin y App Manager, además del titular de la cuenta. App Manager es el rol más pequeño que gestiona precios; Developer, Marketing, Finance y Sales no pueden.
¿Quién puede crear una clave de API de App Store Connect?
Las claves de equipo las genera alguien con una cuenta Admin, después de que el titular de la cuenta haya solicitado el acceso a la API para el equipo. Las claves individuales se generan desde el perfil del propio usuario si un Admin le ha concedido ese permiso.
¿Puedo usar una clave de API individual para los precios?
Funciona para precios si el rol del propio usuario lo permite, pero una clave de equipo es la mejor opción: tiene un rol explícito y sobrevive a que el usuario se vaya. Las claves individuales tampoco pueden acceder a los informes de Sales y Finance.
¿Es seguro darle mi clave de API a una herramienta de precios?
Solo si confías en cómo guarda la clave, porque la clave puede hacer todo lo que permita su rol. Usa una clave de equipo dedicada con el rol más pequeño que funcione y revócala cuando dejes de usar la herramienta.
Pruébalo
Cambia el precio en todos los territorios a partir de un solo precio base
Niveles, ajuste a puntos de precio, una tabla de revisión y una sola confirmación, mediante la API de App Store Connect. Primer mes gratis y después $1 por app al mes.