Global Catalog REST wurde eingestellt, Offline-Token laufen nächstes Jahr zwingend ab
Global Catalog REST wurde eingestellt, Offline-Token laufen nächstes Jahr zwingend ab
Ab dem 2. November wird die Global Catalog REST API keinen Datenverkehr mehr bedienen. Alle Anfragen an discover.shopifyapps.com/global/... schlagen direkt fehl, einschließlich der Abfragen von gespeicherten Katalogen. Im April wurde die API als veraltet markiert und die offizielle Alternative, der Global Catalog MCP, wurde bereitgestellt; das sechsmonatige Übergangsfenster ist nun abgelaufen.
Auf der anderen Seite steht das nächste Jahr. Am 27. Oktober hat Shopify den Zeitrahmen für die Durchsetzung von Offline-Token festgelegt: Ab dem 1. Januar 2027 werden nicht migrierte öffentliche Apps aus dem Store entfernt, und ab dem 1. April geben alte Tokens HTTP 403 zurück. Beide Punkte erfordern Codeänderungen, wobei der erste heute dringend ist und der andere in zwei Monaten ansteht – also nicht auf die lange Bank schieben.
Der seit gestern nicht mehr funktionierende Endpunkt
Die Global Catalog REST API wurde im April 2026 als veraltet markiert, der Nachfolger Global Catalog MCP implementiert das Universal Commerce Protocol (UCP). Nach dem 2. November werden alle vier Endpunkte den Dienst einstellen:
GET /global/v2/searchGET /global/v2/p/{upid}GET /global/v2/p/by-variant/{vid}POST /global/v2/lookup
Am stärksten betroffen sind Apps, die eine Aggregation über mehrere Shops hinweg durchführen. Zum Beispiel ein Team, das Preisvergleiche für Haustierbedarf macht und in seinem Auswahlwerkzeug zweihundert überwachte Produkte gespeichert hat, die jede Nacht mit /global/v2/lookup abgerufen werden, um die neuesten Preise zu erhalten und am Morgen den Nutzern einen Preisvergleichsbericht zu liefern. Nach dem 2. November schlägt die erste Anfrage dieser Aufgabe fehl, der Bericht bleibt leer, und die Händler werden am selben Tag feststellen, dass sich die Preise nicht mehr ändern. Preisvergleiche, die Suche im gesamten Netz und die Produktsuche über verschiedene Shops, die auf diesen Katalog-Endpunkt angewiesen sind, verlieren am selben Tag ihre Datenquelle.
Auch gespeicherte Kataloge sind betroffen. Nach der Abschaltung gibt es keine Puffer, und ob alte Adressen umgeleitet werden, ist nicht klar angegeben; im Changelog steht nur, dass der Dienst eingestellt wurde. Ich gehe davon aus, dass es keinen Puffer gibt, und wenn die geplanten Aufgaben weiterhin auf diese Domain zugreifen, sollten jetzt Alarme ausgelöst werden.
Umstellung
Der Kern besteht darin, die vier REST-Aufrufe durch drei UCP-Tools zu ersetzen, die an https://catalog.shopify.com/api/ucp/mcp gesendet werden:
- Suche →
search_catalog, unterstützt Filterung, Paginierung, Käuferkontext - Einzelprodukt und Variante →
get_product, Identifikator übergebengid://shopify/p/{upid}odergid://shopify/ProductVariant/{id} - Batch →
lookup_catalog, maximal 50 auf einmal
Zwei leicht zu übersehende Details: Jede Anfrage muss meta.ucp-agent.profile enthalten, der Wert ist die Agent-Profil-URL; beim Abrufen von gespeicherten Katalogen muss catalog.catalog_id übergeben werden, nicht mehr die alte Endpunkt-URL zusammensetzen.
Die Authentifizierungsmethode bleibt unverändert, weiterhin werden die Client-Credentials des Dev Dashboards gegen ein Bearer-Token eingetauscht.
Wer zuerst testen und dann umstellen möchte, kann mit dem UCP CLI den Befehl ucp catalog search ausführen; das CLI ist auf github.com/Shopify/ucp-cli verfügbar. Ich habe die Fehlerformen von UCP im realen Datenverkehr noch nicht getestet, daher kann ich dazu nichts Genaues sagen; zuerst im Testumfeld erfolgreich durchführen, bevor man in die Produktion wechselt.
Changelog: https://shopify.dev/changelog/posts/global-catalog-rest-api-stops-serving-traffic-on-november-2-2026
Die drei Daten für Tokens, nur der 1. Januar ist zwingend zu beachten
Diese Angelegenheit wurde seit Jahresbeginn vorbereitet: Ab dem 1. April 2026 müssen neu erstellte öffentliche Apps zwingend ablaufende Tokens verwenden, und am 20. Mai wurde der Umfang auf alle öffentlichen Apps ausgeweitet. Zu diesem Zeitpunkt wurde nur der 1. Januar genannt, am 27. Oktober hat Shopify den Zeitrahmen für die Frist vervollständigt:
- 1. Januar 2027: Nicht migrierte Apps werden aus dem App Store entfernt und die Installation neuer Apps wird untersagt, bestehende Installationen funktionieren weiterhin.
-
- Januar 2027: Händler sehen eine Warnung im Shopify-Admin.
- 1. April 2027: Anfragen an die Admin API mit nicht abgelaufenen Offline-Tokens geben HTTP 403 zurück.
Die offizielle Aussage ist klar: Der 1. Januar ist die Frist für die Migration, die beiden nachfolgenden Daten sind Puffer für die Händler, nicht für dich. Der Code muss bis zum 31. Dezember geändert sein.
Warum so straff? Der offizielle Grund ist der Radius der Offenlegung. Ein nicht abgelaufener Token, der einmal offengelegt wird, bleibt dauerhaft gültig, das Angriffsfenster hat keine Obergrenze; ablaufende Tokens laufen nach 60 Minuten ab und werden automatisch rotiert, wodurch der Einfluss auf eine Stunde begrenzt wird. Der Umfang muss klar definiert werden: Betroffen sind öffentliche Apps, die die Admin API aufrufen; benutzerdefinierte Apps, von Händlern erstellte Apps und Online-Zugriffstokens sind nicht betroffen. Viele Teams haben interne Tools als öffentliche Apps veröffentlicht, und dieser Teil wird am leichtesten übersehen; es lohnt sich, zuerst eine Selbstprüfung durchzuführen, bevor man handelt.
Die Migration ist einfacher als gedacht. Händler müssen nichts neu installieren; im Code kann der vorhandene Token einfach ausgetauscht werden; die offiziellen Vorlagen und API-Bibliotheken haben bereits die Aktualisierung implementiert, sodass nur der Token-Austausch und die Aktualisierung der Speicherung selbst durchgeführt werden müssen. Anleitung: https://shopify.dev/docs/apps/build/authentication-authorization/migrate-to-expiring-offline-access-tokens
Ende Oktober gibt es noch eine nützliche Absicherung: Client-Credentials-Zugriff. Früher musste man warten, bis der Händler die App neu öffnete, wenn das Refresh-Token verloren ging; jetzt kann der Backend-Server mit dem privaten Schlüssel der App direkt ein neues Zugriffstoken anfordern. Für alte Apps, die in über tausend Shops installiert sind, ist diese Absicherung die Migration wert.
Handlich
Die gleiche Ankündigung hat auch zwei kostengünstige Schalter bereitgestellt: Der Abschnitt [network_access] wurde in shopify.app.toml hinzugefügt, um die Server und Websites zu deklarieren, auf die die App zugreifen kann; das Dev Dashboard unterstützt eine IP-Whitelist. Vor der Veröffentlichung sollte shopify app security check einmal durchlaufen werden.
Zeitplan
Für diejenigen, die noch auf REST setzen, gibt es keinen Zeitplan; die Schnittstelle ist bereits tot, heute ist der Migrationstag. Für diejenigen, die nicht abgelaufene Tokens verwenden, sollte die Migration in Q4 eingeplant werden, um nicht bis Januar zu warten, wenn die Händler die Warnungen sehen und Supportanfragen aufkommen.