Logo

Global Catalog REST ha sido descontinuado, el Token fuera de línea expirará obligatoriamente el próximo año

avatar jayce 04 Nov 2026

Global Catalog REST ha sido descontinuado, el Token fuera de línea expirará obligatoriamente el próximo año

A partir del 2 de noviembre, la API Global Catalog REST ya no atenderá ningún tráfico. Todas las solicitudes a discover.shopifyapps.com/global/... fallarán directamente, incluyendo las consultas de catálogos guardados. Cuando se depreció en abril, la oficial ya proporcionó un reemplazo: Global Catalog MCP, y se ha agotado el período de seis meses.

Por otro lado, el próximo año. El 27 de octubre, Shopify fijó la línea de tiempo para la aplicación del Token fuera de línea: las aplicaciones públicas que no se hayan migrado serán retiradas el 1 de enero de 2027, y a partir del 1 de abril, los Tokens antiguos devolverán HTTP 403. Ambas cosas requieren cambios en el código; una es urgente hoy, la otra tiene dos meses, no la tomes como si no fuera urgente.

La interfaz que dejó de funcionar ayer

La API Global Catalog REST fue marcada como deprecada en abril de 2026, y su reemplazo, Global Catalog MCP, implementa el Protocolo de Comercio Universal (UCP). Después del 2 de noviembre, los cuatro puntos finales dejarán de funcionar:

  • GET /global/v2/search
  • GET /global/v2/p/{upid}
  • GET /global/v2/p/by-variant/{vid}
  • POST /global/v2/lookup

Los más afectados son las aplicaciones que realizan agregaciones entre tiendas. Por ejemplo, un equipo que compara precios de productos para mascotas tiene doscientos productos monitoreados en su herramienta de selección, y cada noche utiliza /global/v2/lookup para obtener los precios más recientes, generando un informe de comparación para los usuarios por la mañana. Después del 2 de noviembre, la primera solicitud de esta tarea fallará, el informe estará vacío, y los comerciantes podrán notar que los precios no se han actualizado. La comparación de precios, la búsqueda en toda la red y la búsqueda de productos entre tiendas, todas las funciones que dependen de esta interfaz de catálogo perderán su fuente de datos el mismo día.

Los catálogos guardados también dejarán de funcionar. No está claro si habrá un período de gracia después de la detención del servicio o si las direcciones antiguas serán redirigidas; el changelog solo menciona que deja de atender tráfico. Estoy asumiendo que no habrá un período de gracia, y las tareas programadas que aún están llamando a este dominio deberían estar recibiendo alertas ahora.

Cambios necesarios

La clave es reemplazar las cuatro llamadas REST por tres herramientas UCP, enviándolas a https://catalog.shopify.com/api/ucp/mcp:

  • Búsqueda → search_catalog, soporta filtrado, paginación y contexto del comprador
  • Producto y variante → get_product, el identificador se pasa como gid://shopify/p/{upid} o gid://shopify/ProductVariant/{id}
  • Lote → lookup_catalog, hasta un máximo de 50 a la vez

Dos detalles fáciles de pasar por alto: cada solicitud debe incluir meta.ucp-agent.profile, cuyo valor es la URL del perfil del agente; para consultar catálogos guardados, se debe enviar catalog.catalog_id, no vuelvas a concatenar la URL del antiguo punto final.

El método de autenticación no cambia, sigue siendo el intercambio de credenciales del cliente del Dev Dashboard por un token de portador.

Si deseas probar antes de hacer cambios, utiliza UCP CLI para ejecutar ucp catalog search, el CLI está en github.com/Shopify/ucp-cli. No he probado aún la forma en que los errores de UCP se presentan en tráfico real, así que no puedo asegurar nada; primero corre en un entorno de prueba antes de pasar a producción.

changelog: https://shopify.dev/changelog/posts/global-catalog-rest-api-stops-serving-traffic-on-november-2-2026

Las tres fechas del Token, solo el 1 de enero es la que debes atender

Este asunto comenzó a gestarse a principios de año: a partir del 1 de abril de 2026, la creación de nuevas aplicaciones públicas obligará a usar tokens que expiran, y el 20 de mayo el changelog amplió el alcance a todas las aplicaciones públicas. En ese momento solo se mencionó el 1 de enero, y el 27 de octubre la oficial completó la línea de tiempo de vencimiento:

  • 1 de enero de 2027: las aplicaciones no migradas serán retiradas de la App Store y se prohibirá su nueva instalación, las instalaciones existentes seguirán funcionando.
  • 15 de enero de 2027: los comerciantes verán una advertencia en el admin de Shopify.
  • 1 de abril de 2027: las solicitudes de la API Admin con tokens fuera de línea no expirada devolverán HTTP 403.

La declaración oficial es muy clara: el 1 de enero es la fecha límite para la migración, las dos fechas posteriores son un período de gracia para los comerciantes, no una extensión para ti. El código debe estar listo antes del 31 de diciembre.

¿Por qué es tan estricto? La razón oficial es el radio de filtración. Un token no expirada, si se filtra, es permanentemente válido, y la ventana de ataque no tiene límite; el token que expira se renueva automáticamente cada 60 minutos, limitando el impacto a una hora. Es importante aclarar el alcance: las aplicaciones públicas que llaman a la API Admin son las afectadas, las aplicaciones personalizadas, las aplicaciones construidas por comerciantes y los tokens de acceso en línea no están en la lista. Muchos equipos convierten herramientas internas en aplicaciones públicas, y esta parte es la más fácil de pasar por alto, así que vale la pena revisarla antes de hacer cambios.

La migración es más fácil de lo que parece. Los comerciantes no necesitan reinstalar, solo necesitan intercambiar el token existente en el código; la plantilla oficial y las bibliotecas de API ya implementaron la renovación, lo único que debes hacer es el intercambio de tokens y la actualización del almacenamiento. Guía: https://shopify.dev/docs/apps/build/authentication-authorization/migrate-to-expiring-offline-access-tokens

A finales de octubre hay una solución útil: acceso con credenciales de cliente. Antes, si se perdía el token de renovación, solo se podía esperar a que el comerciante reiniciara la aplicación; ahora el backend puede usar la clave privada de la aplicación para firmar y obtener un nuevo token de acceso directamente. Para aplicaciones antiguas que están instaladas en miles de tiendas, esta solución compensa el costo de migración.

A mano

El mismo anuncio también proporcionó dos cambios de bajo costo: se agregó la sección [network_access] en shopify.app.toml, declarando los servidores y sitios que la aplicación puede acceder; el Dev Dashboard ahora soporta listas de permitidos por IP. Corre shopify app security check antes de publicar.

Cronograma

No hay cronograma para aquellos que aún están ajustando REST, la interfaz ya está muerta, hoy es el día de migración. Para aquellos que usan tokens no expirada, programa la migración para el cuarto trimestre, no esperes hasta enero cuando los comerciantes comiencen a ver advertencias y los tickets de soporte lleguen a ti para actuar.

Tags
shopify
Global Catalog
UCP
API 迁移
预约免费 30 分钟咨询