Ayuda
Diagnóstico objetivo, sin adivinar.
Usa el código HTTP y el mensaje de la respuesta para identificar el siguiente paso.
Situaciones comunes
La primera vista previa tardó
El primer uso del día puede enfrentar un cold-start. La interfaz indica que la generación puede tardar hasta unos 40 segundos; espera la sesión o genera de nuevo si expira.
Recibí 401 al llamar a la API
Envía un Bearer JWT válido o X-API-Key en los endpoints que aceptan API key. Las claves ausentes o inválidas devuelven 401.
Recibí 402 al iniciar un build
Se alcanzó la cuota gratuita mensual y no hay plan activo ni saldo de créditos. Consulta la billetera o inicia checkout/top-up.
Recibí 422 al crear un build
Confirma que la app tiene manifiesto y que contiene app_name y primary_color. Las validaciones de formato y campos obligatorios también devuelven 422.
El push no llegó
Confirma el dispositivo, el token y el canal. La infraestructura FCM está integrada, pero la validación de entrega de extremo a extremo en dispositivo físico sigue pendiente.
Apple o Google rechazó la publicación
La documentación de términos está en revisión. El flujo propuesto es corregir las pendencias elegibles y reenviar en el mismo pedido; el contenido del cliente y los datos faltantes pueden quedar fuera de la cobertura.