Einen API-Schlüssel finden oder erstellen

Für Integrationen mit externen Systemen wie Shipmondo, E-conomic, Klaviyo und anderen benötigst du ein API-Token von Shoporama. Hier findest du sie und erfährst, wie die Nutzungslimits funktionieren.

Finde deine API-Token

1. Gehe zu „Integrationen“ → „API-Zugriff“ (oder direkt zu /webshop/api)
2. Hier wird eine Liste aller Token des Shops angezeigt, einschließlich ihrer Zugriffsebene, des täglichen Verbrauchs und des Zeitpunkts der letzten Nutzung
3. Klicke auf ein Token, um den vollständigen Wert anzuzeigen oder zu kopieren

Bei Shoporama gibt es nicht nur einen einzigen „API-Schlüssel“ pro Shop, sondern eine Liste von Tokens, von denen du mehrere parallel nutzen kannst, z. B. einen für Shipmondo, einen für E-conomic und einen für dein eigenes Skript.

Neues API-Token erstellen

1. Gehen Sie zu „Integrationen“ → „API-Zugriff“
2. Klicken Sie auf „Token erstellen“
3. Gib ihm einen aussagekräftigen Namen (z. B. „Shipmondo“) und wähle die Zugriffsebene aus
4. Das neue Token wird angezeigt und ist einsatzbereit

API-Limits und -Nutzung

Jedes API-Token hat ein tägliches Limit für die Anzahl der zulässigen Aufrufe. Dies schützt den Shop vor einer außer Kontrolle geratenen Integration und sorgt für eine vorhersehbare Nutzung. Neue Token erhalten standardmäßig ein Limit von 10.000 Aufrufen pro Tag, das du jederzeit selbst erhöhen oder senken kannst.

Was zählt als Aufruf?

Ein Aufruf ist eine HTTP-Anfrage an die REST-API. Wenn du mit einer einzigen Anfrage eine Liste mit 100 Produkten abrufst, zählt dies als ein Aufruf, liefert aber 100 Produkte zurück. Wenn du sie einzeln abrufst, zählt dies als 100 Aufrufe. Verwende daher nach Möglichkeit Listen-Endpunkte (z. B. /products), anstatt nach ID abzufragen.

So siehst du den Verbrauch ein

In der Liste unter „Integrationen“ → „API-Zugriff“ kannst du den aktuellen Verbrauch für jedes Token einsehen. Wenn du auf ein Token klickst, wird ein farbiger Fortschrittsbalken (grün, gelb bei 70 %, rot bei 90 %) angezeigt, der angibt, wie nah das Token am Limit ist.

Was passiert, wenn das Limit erreicht wird?

Wenn ein Token sein Tageslimit erreicht, antwortet die API bei nachfolgenden Aufrufen mit dem HTTP-Status 429 „Too Many Requests “. Der Client muss bis zum nächsten Tag warten, an dem der Zähler automatisch zurückgesetzt wird. Sie erhalten eine Benachrichtigungs-E-Mail pro Tag, wenn dies geschieht, nicht eine pro blockierter Anfrage, sodass Ihr Posteingang nicht überflutet wird.

So erhöhen Sie das Limit

1. Gehe zu „Integrationen“ → „API-Zugriff“
2. Klicke auf das Token, das du ändern möchtest
3. Gib einen neuen Wert in das Feld „Maximales Tageslimit“ ein (in Schritten von 100 anpassbar)
4. Klicken Sie auf „Speichern“

Kontingent für Aufrufe

Zusätzlich zu den tokenbezogenen Limits verfügt jeder Shop über ein Gesamtkontingent an kostenlosen Aufrufen, das in seinem Preismodell enthalten ist:

• Flex: 1.000 Aufrufe pro Tag kostenlos enthalten
• Pro: 10.000 Aufrufe pro Tag kostenlos enthalten
• Darüber hinaus werden 0,01 DKK pro zusätzlichem Aufruf in Rechnung gestellt

Der Pool wird über alle Token des Shops hinweg zusammengezählt. Die aktuellen Zahlen findest du immer auf der Preisseite. Typische Integrationen wie Shipmondo, E-conomic, Klaviyo und Preisüberwachungsdienste liegen im täglichen Betrieb normalerweise weit unter diesem Limit.

Wozu dient ein API-Token?

Ein API-Token ermöglicht externen Systemen den Zugriff auf die Daten in deinem Shop zum Lesen und Schreiben über die REST-API. Typische Integrationen:

• Shipmondo: zum Abrufen von Bestellungen und Erstellen von Sendungen
• E-conomic / Dinero: zum Synchronisieren von Bestellungen und Rechnungen
• Klaviyo / Heysender: für E-Mail-Marketing
• Eigene Integrationen: Abrufen von Produkten, Bestellungen und Kundendaten

Häufig gestellte Fragen

Warum habe ich nach einem CSV-Import plötzlich das Limit erreicht?

Ein Import über eine Integration kann viele Aufrufe pro Zeile auslösen. Wenn beispielsweise bei jedem Artikel sowohl das Produkt als auch der Lagerbestand und der Preis aktualisiert werden, können aus 500 Zeilen schnell 1.500 Aufrufe werden. Überprüfe das Protokoll des externen Dienstes und erhöhe gegebenenfalls das tägliche Limit des Tokens, wenn du regelmäßig große Importe durchführst.

Erhalten meine Kunden ebenfalls 429-Fehler im Shop?

Nein. Das Limit gilt nur für Integrationen, die ein API-Token verwenden. Deine Kunden nutzen den Shop in ihrem Browser über eine normale Sitzung, völlig unabhängig von der API, und sind niemals vom Token-Verbrauch betroffen.

Was ist der Unterschied zwischen Flex und Pro in Bezug auf die API?

Flex umfasst 1.000 kostenlose Aufrufe pro Tag, Pro umfasst 10.000. Dabei handelt es sich um ein gemeinsames Kontingent für alle Token des Shops. Aufrufe, die dieses Kontingent überschreiten, kosten 0,01 DKK pro Stück. Das Limit pro Token legst du selbst fest, unabhängig vom Preismodell.

Wie kann ich in der Abrechnung sehen, für wie viele zusätzliche Aufrufe ich bezahlt habe?

Zusätzliche API-Aufrufe, die über das inbegriffene Kontingent hinausgehen, werden monatlich abgerechnet und erscheinen als eigene Zeile auf deiner monatlichen Shoporama-Rechnung. Diese Kosten sind vom Abonnement getrennt, sodass du den Verbrauch in deiner Buchhaltung klar erkennen kannst.

Wo kann ich herausfinden, welches Token am meisten verbraucht?

In der Liste unter „API-Zugriff“ kannst du nach „Täglicher Verbrauch“ sortieren und den Verbrauch pro Token einsehen. Am einfachsten ist es, wenn du jeder Integration ein eigenes Token mit einem aussagekräftigen Namen zugewiesen hast (z. B. „Shipmondo“, „E-conomic“, „Eigenes Skript“).

Werde ich benachrichtigt, bevor ich das Limit erreiche?

Du erhältst eine E-Mail an dem Tag, an dem das Limit erreicht wird (eine pro Tag, nicht pro blockierter Anfrage). Wenn du früher benachrichtigt werden möchtest, behalte den Fortschrittsbalken auf der Token-Seite im Auge. Er wechselt bei 70 % zu Gelb und bei 90 % zu Rot.

Was mache ich jetzt, wenn meine Integration unterbrochen wurde?

Gehe zu „Integrationen“ → „API-Zugriff“, klicke auf das Token und erhöhe das „Tägliche Höchstlimit“. Speichere die Änderung. Die Integration kann sofort wieder Aufrufe ausführen. Der Zähler wird automatisch zum Tageswechsel zurückgesetzt.

Mein Lagersystem führt nachts Tausende von Aufrufen durch. Ist das normal?

Bei einer vollständigen Synchronisierung kann das normal sein, aber oft lässt sich die Integration so einstellen, dass nur die Änderungen seit dem letzten Abruf (Delta-Sync) statt des gesamten Bestands abgerufen werden. Überprüfen Sie die Einstellungen im Lagersystem oder fragen Sie den Anbieter, ob es einen „Nur-Änderungen“-Modus gibt.

Siehe auch: Webhooks in Ihrem Shop anzeigen.

Benötigen Sie Hilfe? Kontaktieren Sie uns unter support@shoporama.dk.