Einen API-Schlüssel finden oder erstellen

Für Integrationen mit externen Systemen wie Shipmondo, E-conomic, Klaviyo und anderen benötigen Sie ein API-Token von Shoporama. Hier können Sie diese finden und erfahren, wie die Ausgabenlimits funktionieren.

Finden Sie Ihre API-Tokens

1. Gehen Sie zu Konto → Online Shop → API-Zugang (oder direkt zu /webshop/api)
2. Hier sehen Sie eine Liste aller Token im Shop, ihre Zugriffsstufe, die tägliche Nutzung und wann sie zuletzt genutzt wurden
3. Klicken Sie auf ein Token, um den vollständigen Wert anzuzeigen oder zu kopieren

In Shoporama gibt es nicht einen einzigen "API-Schlüssel" pro Shop, sondern eine Liste von Token, von denen Sie mehrere parallel haben können, z.B. einen für Shipmondo, einen für E-conomic und einen für Ihr eigenes Skript.

Erstellen Sie ein neues API-Token

1. Gehen Sie zu Konto → Webshop → API-Zugang
2. Klicken Sie auf Neues Token erstellen
3. Geben Sie ihm einen beschreibenden Namen (z. B. "Shipmondo") und wählen Sie die Zugriffsstufe
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 Aufrufe, die es tätigen kann. Dies schützt den Shop vor einer ausufernden Integration und hält den Verbrauch vorhersehbar. Für neue Token gilt standardmäßig ein Limit von 10.000 Aufrufen pro Tag, das Sie jederzeit selbst erhöhen oder senken können.

Was zählt als ein Aufruf?

Ein Aufruf ist eine HTTP-Anfrage an die REST-API. Das Abrufen einer Liste von 100 Produkten mit einer Anfrage zählt als ein Aufruf, liefert aber 100 Produkte. Wenn Sie sie einzeln abrufen, zählt dies als 100 Aufrufe. Verwenden Sie daher, wann immer möglich, Listenendpunkte (z. B. /products), anstatt nach einzelnen IDs zu suchen.

So sehen Sie den Verbrauch

In der Liste unter Konto → Webshop → API-Zugang können Sie den aktuellen Verbrauch für jedes Token sehen. Wenn Sie auf ein Token klicken, zeigt ein farbiger Fortschrittsbalken (grün, gelb bei 70%, rot bei 90%) an, wie nahe das Token am Limit ist.

Was passiert, wenn das Limit erreicht ist?

Wenn ein Token sein Tageslimit erreicht, antwortet die API bei nachfolgenden Aufrufen mit HTTP 429 Too Many Requests. Der Client muss bis zu den nächsten 24 Stunden warten, in denen der Zähler automatisch zurückgesetzt wird. Sie erhalten in diesem Fall eine Benachrichtigung pro Tag und nicht eine pro blockierter Anfrage, damit Ihr Posteingang nicht überflutet wird.

So erhöhen Sie das Limit

1. Gehen Sie zu Konto → Online-Shop → API-Zugang
2. Klicken Sie auf das Token, das Sie ändern möchten
3. Geben Sie einen neuen Wert in das Feld Maximales Tageslimit ein (angepasst in 100er-Schritten)
4. Klicken Sie auf Speichern

Preisgestaltung für Aufrufe

Zusätzlich zu den Begrenzungen pro Token verfügt jeder Shop über einen Gesamtpool an kostenlosen Anrufen, der in seinem Preismodell enthalten ist:

• Flex: 1.000 Anrufe pro Tag sind kostenlos
• Pro: 10.000 Anrufe pro Tag kostenlos
• Darüber hinaus werden 0,01 € pro zusätzlichem Anruf berechnet.

Der Pool wird für alle Token des Shops zusammengerechnet. Die aktuellen Zahlen finden Sie immer auf der Preisseite. Typische Integrationen wie Shipmondo, E-conomic, Klaviyo und Preisbeobachter nutzen in der Regel weit unter diesem Limit im täglichen Betrieb.

Wofür wird ein API-Token verwendet?

Ein API-Token ermöglicht es externen Systemen, über die REST-API Daten in Ihrem Shop zu lesen und zu schreiben. Typische Integrationen:

• Shipmondo: zum Abrufen von Bestellungen und Erstellen von Sendungen
• E-conomic / Dinero: zur Synchronisierung von Bestellungen und Rechnungen
• Klaviyo / Heysender: für E-Mail-Marketing
• Benutzerdefinierte Integrationen: zum 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 zum Beispiel jeder Artikel sowohl Produkt, Bestand und Preis aktualisiert, können aus 500 Zeilen schnell 1.500 Aufrufe werden. Überprüfen Sie das Protokoll im externen Dienst und erhöhen Sie das Tageslimit des Tokens, wenn Sie regelmäßig große Importe haben.

Bekommen meine Kunden auch 429 Fehler im Shop?

Nein, das werden sie nicht. Das Limit gilt nur für Integrationen, die ein API-Token verwenden. Ihre Kunden nutzen den Shop in ihrem Browser über eine reguläre Sitzung, völlig außerhalb der API, und sind von der Verwendung des Tokens nicht betroffen.

Was ist der Unterschied zwischen Flex und Pro, wenn es um die API geht?

Flex umfasst 1.000 kostenlose Aufrufe pro Tag, Pro umfasst 10.000. Dies ist ein Gesamtpool für alle Token des Shops. Darüber hinausgehende Anrufe kosten jeweils 0,01 €. Sie legen das Limit pro Token selbst fest, unabhängig vom Preismodell.

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

Zusätzliche API-Aufrufe, die über den enthaltenen Pool hinausgehen, werden pro Monat berechnet und erscheinen als Einzelposten auf Ihrer monatlichen Shoporama-Rechnung. Dieser Posten ist vom Abonnement getrennt, so dass Sie die Nutzung in der Buchhaltung klar erkennen können.

Wo kann ich herausfinden, welches Token am meisten genutzt wird?

In der Liste unter API-Zugang können Sie nach "Tägliche Nutzung" sortieren und die Nutzung pro Token sehen. Dies ist am einfachsten, wenn Sie jeder Integration ein eigenes Token mit einem aussagekräftigen Namen gegeben haben (z. B. "Shipmondo", "e-conomic", "Eigenes Skript").

Kann ich benachrichtigt werden, bevor ich das Limit erreiche?

Sie erhalten eine E-Mail an dem Tag, an dem das Limit erreicht wird (eine pro Tag, nicht pro blockierter Anfrage). Wenn Sie eine frühere Benachrichtigung wünschen, sollten Sie den Fortschrittsbalken auf der Token-Seite im Auge behalten. Er wird bei 70% gelb und bei 90% rot.

Was muss ich jetzt tun, wenn meine Integration gestoppt wurde?

Gehen Sie zu Konto → Webshop → API-Zugang, klicken Sie auf das Token und erhöhen Sie "Maximales Tageslimit". Speichern Sie. Die Integration kann sofort wieder Aufrufe tätigen. Der Zähler wird am Ende des Tages automatisch zurückgesetzt.

Mein Warenwirtschaftssystem tätigt nachts Tausende von Aufrufen. Ist das normal?

Bei einer vollständigen Synchronisierung kann das normal sein, aber oft kann die Integration so eingestellt werden, dass sie nur die Änderungen seit dem letzten Mal abruft (Delta-Synchronisierung) und nicht den gesamten Bestand. Prüfen Sie die Einstellungen im Speichersystem oder fragen Sie Ihren Lieferanten, ob es einen Modus "nur Änderungen" gibt.

Siehe auch: Siehe Webhooks in Ihrem Shop.

Brauchen Sie Hilfe? Kontaktieren Sie uns unter support@shoporama.dk.