Die Admin API und Webhooks in der Praxis
Integrationen mit Shopify basieren hauptsächlich auf zwei Mechanismen: der Admin API, die Sie aufrufen, um zu lesen und zu schreiben, und Webhooks, die Sie aufrufen, wenn etwas passiert.
Beide sind unkompliziert. Was eine zuverlässige Integration von einer fehlerhaften unterscheidet, ist der Umgang mit Fällen, in denen sie sich nicht wie erwartet verhalten – und das werden sie.
Die zwei Mechanismen#
| Admin API | Webhooks | |
|---|---|---|
| Richtung | Sie rufen Shopify auf | Shopify ruft Sie auf |
| Geeignet für | Status lesen, Änderungen schreiben, Nachfüllungen | Zeitnah auf Ereignisse reagieren |
| Fehlermodus | Rate Limits, Versionsänderungen | Duplikate, Zustellung außer Reihenfolge, verpasste Ereignisse |
| Muss behandelt werden | Wiederholungen und Paginierung | Idempotenz und Verifizierung |
Regeln, die Integrationen zuverlässig machen#
- Verifizieren Sie jede Webhook-Signatur, bevor Sie der Payload vertrauen. Nicht verifizierte Endpunkte sind eine offene Tür.
- Machen Sie jeden Handler idempotent – dasselbe Ereignis wird irgendwann zweimal eintreffen.
- Gehen Sie nicht von einer Reihenfolge aus. Eine Stornierung kann vor der Erstellung eintreffen, auf die Sie gewartet haben.
- Antworten Sie schnell und verarbeiten Sie asynchron; langsame Endpunkte werden wiederholt und dann deaktiviert.
- Gleichen Sie täglich mit der API ab. Webhooks verpassen Ereignisse; ein nächtlicher Durchlauf fängt auf, was durchgerutscht ist.
Rate Limits sind eine Designvorgabe#
Shopify misst den API-Zugriff. Das ist kein Hindernis, das man mit Wiederholungen umgehen kann; es ist eine Einschränkung, für die man designen muss. Bündeln Sie Lesevorgänge, fordern Sie nur die Felder an, die Sie benötigen, und verwenden Sie Bulk-Operationen für Nachfüllungen, anstatt jedes Produkt einzeln mit einem Aufruf abzurufen.
Wenn Ihre Integration nur funktioniert, wenn nichts anderes läuft, funktioniert sie nicht. Testen Sie sie, während ein Import läuft.
Versionierung#
API-Versionen sind datiert und laufen ab. Tragen Sie das Upgrade in den Kalender ein, anstatt es durch einen Fehler zu entdecken. Eine kleine Integration braucht eine Stunde für den Wechsel; eine, die vier Versionen übersprungen hat, braucht eine Woche.
Häufige Fragen
Webhooks oder Polling?
Webhooks für Schnelligkeit, eine periodische Abgleichung für Korrektheit. Die meisten zuverlässigen Integrationen verwenden beides.
Wie verhindere ich doppelte Verarbeitung?
Speichern Sie die Ereigniskennung und ignorieren Sie Wiederholungen. Idempotenz ist die wertvollste Gewohnheit hier.
Was bricht zuerst bei Skalierung?
Rate Limits, normalerweise während einer Nachfüllung, die Datensätze einzeln durchläuft, anstatt Bulk-Operationen zu verwenden.
shopify admin apishopify webhooksshopify integrationshopify api rate limitsshopify graphql api
