Die Grenzen der beiden Shopware-APIs

Funktionslisten beantworten die Frage „geht das?". Die Frage, die eine Integration teuer oder billig macht, ist eine andere: wie oft muss ich fragen?

Drei Zahlen

Gemessen durch reale Aufrufe mit steigendem limit. Bei Überschreitung:

{
  "code": "FRAMEWORK__QUERY_LIMIT_EXCEEDED",
  "detail": "The limit must be lower than or equal to MAX_LIMIT(=500). Given: 501",
  "source": { "pointer": "/limit" },
  "meta": { "parameters": { "maxLimit": 500, "limit": 501 } }
}

Die Antwort nennt die erlaubte Obergrenze im Klartext — ein Client kann sie auslesen, statt sie zu raten. Das ist selten und angenehm.

In 6.6.10.6 und 6.7.13.1 identisch. Beide Grenzen sind keine Versionsfrage.

Was daraus folgt

Ein Katalog mit 10.000 Produkten:

Das ist der Unterschied, der in der Architekturentscheidung zählt — nicht die Frage, ob ein Endpunkt existiert.

Und er verschärft sich mit der zweiten Zahl: 600 Sekunden Tokenlaufzeit. Ein Abzug, der länger dauert, muss den Token mitten im Lauf erneuern. Das ist kein Problem, wenn man es einplant, und eine sporadisch fehlschlagende Integration, wenn nicht.

Die Tokenantwort

{
  "token_type": "Bearer",
  "expires_in": 600,
  "refresh_token": "def502…"
}

Zehn Minuten, mit refresh_token. Der richtige Umgang damit ist: Token zwischenspeichern, Ablaufzeitpunkt mitführen, kurz vor Ablauf über das refresh_token erneuern — und nicht bei jedem Aufruf neu anmelden.

Wer bei jedem Aufruf grant_type: password schickt, läuft in die Ratenbegrenzung des OAuth-Endpunkts, die bei zehn Versuchen in zehn Sekunden beginnt und eine Rücksetzfrist von vierundzwanzig Stunden hat. Das ist die häufigste Ursache für Automatisierungen, die wochenlang laufen und dann ohne erkennbaren Anlass abbrechen.

Fehler, die man lesen kann

Zwei Fälle provoziert:

Unbekanntes Feld im Filter

code:   FRAMEWORK__UNMAPPED_FIELD
detail: Field "gibtEsNicht" in entity "product" was not found.

Feld und Entität werden benannt. Ein Tippfehler im Feldnamen ist damit in Sekunden gefunden.

Pflichtfeld fehlt beim Schreiben

pointer: /0/taxRate
detail:  This value should not be blank.

Der Zeiger nennt den Index im Stapel und das Feld. Wer mehrere Datensätze auf einmal schreibt, weiß sofort, welcher davon.

Beides ist maschinell auswertbar. Eine Integration, die diese Antworten protokolliert statt nur den HTTP-Code, spart bei jeder Störung eine Analyserunde.

Die Entscheidung

Grenzen dieser Messung

Gemessen sind die Obergrenzen, nicht das Laufzeitverhalten an der Grenze. Ob 500 Datensätze je Anfrage bei großen Entitäten tatsächlich durchlaufen, hängt an PHP-Speicher, Laufzeitgrenze und der Zahl der geladenen Verknüpfungen — ein Produkt mit Übersetzungen, Preisen und Medien wiegt ein Vielfaches eines Steuersatzes.

Nicht gemessen wurden Antwortzeiten unter Last und das Verhalten hinter einem Reverse Proxy, der eigene Grenzen mitbringen kann.

Und die Tokenlaufzeit ist ein Konfigurationswert der Installation. 600 Sekunden sind der gemessene Wert beider Runtimes, nicht zwingend der Ihres Shops.