DocsBlog
← Todos los artículos
Proyecto de código abiertoUpferry

Tu aplicación de Shopify en Python: presentamos FastAPI Launch Kit

Quieres escribir el backend de tu aplicación de Shopify en Python. Antes de trabajar en sus funciones, necesitas conectar App Bridge, la verificación de solicitudes, los tokens, los webhooks y las tareas en segundo plano, y después alojar la aplicación.

Shopify Python Launch Kit reúne estas piezas en un proyecto portable. Usa el paquete oficial de Python de Shopify e incluye un flujo de despliegue en Upferry para la aplicación web, Postgres y un proceso separado de tareas. El código es gratuito con licencia MIT.

Un proyecto inicial completo. El código sigue siendo portable, y la autenticación y el consentimiento de instalación siguen siendo necesarios.

Empieza con el backend que quieres usar

Shopify publicó nuevos paquetes oficiales de PHP y Python en agosto de 2026. Ofrecen verificación de solicitudes, intercambio de tokens y GraphQL. La guía oficial indica que no existe una plantilla completa oficial de aplicaciones Python: los desarrolladores conectan los componentes.

Este kit está pensado para una aplicación nueva que necesita backend y cuyo desarrollador ya eligió FastAPI. Proporciona una página mínima con App Bridge, instalaciones en Postgres y una tarea de ejemplo. Es un proyecto independiente de Upferry, sin respaldo oficial de Shopify ni garantía de aprobación en App Store.

Tu primer resultado es una aplicación funcionando

El ejemplo muestra el nombre de tu tienda de desarrollo mediante una consulta Admin GraphQL del servidor. Pulsa Run Python job y el proceso separado obtiene el nombre, después devuelve un resultado con su versión de Python y la hora de finalización.

Los tokens de instalación se guardan cifrados en Postgres con una clave que controlas. La pareja de tokens se guarda antes de las siguientes consultas GraphQL y un bloqueo de fila coordina su renovación entre procesos. Volver a desplegar el proceso web conserva la instalación.

La tarea de ejemplo solo lee datos. Añade idempotencia y adapta el tratamiento de datos antes de implementar escrituras o pagos.

Del desarrollo local al alojamiento permanente

El alojamiento Upferry requiere una cuenta GitHub autorizada; el registro público todavía no está disponible. El código y el flujo local están abiertos a todos. También puedes ejecutar los contenedores en otro proveedor.

Obtén el repositorio, instala las dependencias Python, inicia Postgres local y usa el flujo de desarrollo de Shopify CLI. El README incluye los comandos completos. Puedes revisar y ejecutar el código antes de elegir alojamiento.

Para Upferry, vincula una aplicación Shopify separada para la versión alojada y ejecuta uv run python -m app.deploy. El comando inicia sesión en Upferry, crea la base y los dos servicios, aplica las migraciones, despliega la web y después inicia el proceso de tareas.

Actualiza la configuración de publicación e invoca Shopify CLI para revisar y publicar los cambios. Completa la instalación en la tienda de desarrollo desde Dev Dashboard. La configuración local mantiene su propia aplicación y túnel.

Se requieren autenticación y consentimiento. La herramienta no evita los permisos de Shopify, promete tiempos de despliegue ni publica una ficha en App Store.

Conoce los límites del proyecto inicial

Los archivos de entorno, el entorno virtual y el estado local de despliegue quedan fuera del archivo de código. Las variables se envían por separado a la API autenticada de Upferry mediante HTTPS. El registro de solicitudes está desactivado porque las URL de Shopify pueden contener tokens.

El proyecto verifica las firmas de webhooks y comprueba la identidad de la tienda en el cuerpo firmado antes de borrar datos. Los eventos de desinstalación y borrado de tienda eliminan la instalación y sus tareas. El ejemplo no almacena registros de clientes; amplía las solicitudes y eliminaciones de datos cuando tu app empiece a recopilarlos.

Las tareas usan arrendamientos temporales en Postgres e intentos limitados. Una tarea puede ejecutarse más de una vez. Las tareas largas o con escrituras necesitan medidas específicas. El kit no sustituye una auditoría de seguridad o una evaluación de cumplimiento.

Código gratuito, alojamiento opcional

El repositorio y el flujo local son gratuitos. El alojamiento permanente es un servicio separado: la web, la base y el proceso de tareas siguen funcionando después de cerrar tu portátil. El kit no incluye alojamiento de producción ilimitado gratuito.

El Dockerfile también funciona en otros proveedores de contenedores. Los paquetes Django, los proyectos Python de la comunidad y las plantillas Node de Shopify son alternativas válidas. Nos centramos en un proyecto FastAPI mantenido y una ruta preparada para alojar el conjunto en Upferry.

Empieza con el código gratuito y el ejemplo para una tienda de desarrollo. Elige alojamiento cuando necesites funcionamiento permanente.

Obtener Python Launch Kit →