Dieser Artikel erklärt, wie die API-Nutzung bei Easyship abgerechnet wird, was in Ihrem Plan enthalten ist und wie Sie Ihre Nutzung in Ihrem Dashboard überwachen können.
Übersicht
Alle Easyship-Abonnementpläne enthalten ein monatliches Kontingent an API-Aufrufen pro Endpunkt. Sie zahlen nur zusätzlich, wenn Sie Ihr enthaltenes Limit überschreiten, und selbst dann wird Ihr Zugang niemals blockiert.
Die folgenden Endpunkte sind in allen Plänen verfügbar:
- Internationale Adressvalidierung
- Nationale Adressvalidierung
- Tracking von Drittanbietern
- Berechnung von Steuern & Abgaben
- HS-Code-Berechnung
- Tarife
Enthaltene Limits
Jeder Plan enthält eine festgelegte Anzahl von API-Aufrufen pro Endpunkt und Monat. Ihr Kontingent wird jeweils am Verlängerungsdatum Ihres Abonnements zurückgesetzt.
Was auf Ihr Limit angerechnet wird: Nur erfolgreiche API-Aufrufe werden gezählt. Fehlgeschlagene Anfragen werden nicht gezählt oder berechnet.
Enterprise-Kunden: Die API-Nutzung wird erfasst, aber nicht berechnet.
Zusätzliche Gebühren
Wenn Sie Ihr enthaltenes Limit für einen Endpunkt überschreiten, wird Ihnen für die zusätzliche Nutzung ein Aufpreis pro Aufruf berechnet. Ihr Zugang wird niemals blockiert – Ihre Integration funktioniert weiterhin und die Zusatzgebühren werden Ihrer nächsten Monatsrechnung hinzugefügt. Beachten Sie, dass hierfür eine gültige Zahlungskarte hinterlegt sein muss.
Standardmäßige Ratenlimits gelten weiterhin für alle Pläne, um die Systemstabilität zu gewährleisten.
Abrechnungszyklus
API-Nutzungsgebühren werden monatlich abgerechnet und richten sich nach Ihrem Verlängerungsdatum des Abonnements.
- Monatliche Pläne: Abrechnung am jeweiligen Verlängerungsdatum jeden Monat
- Jahrespläne: API-Nutzung wird trotzdem monatlich abgerechnet, nicht jährlich
Beispiel: Wenn Sie am 2. Juni einen Jahresplan abgeschlossen haben, wird Ihre API-Nutzung am 2. jedes Monats abgerechnet.
Jahresabonnenten: Ihre monatliche API-Nutzungsrechnung ist separat von Ihrer jährlichen Abonnementgebühr.
API-Berechtigungen (Scopes)
Scopes definieren, auf welche Endpunkte und Funktionen eine API-Verbindung Zugriff hat. Einige Scopes werden vom Benutzer gesteuert, andere werden von Easyship verwaltet.
Beim Einrichten einer API-Integration wählen Sie zwischen zwei API-Versionen:
- 2023-01 oder früher (Legacy): Scopes werden ohne spezifische Aktionen aufgelistet – das Aktivieren eines Scopes gewährt sowohl Lese- als auch Schreibzugriff auf alle relevanten Endpunkte innerhalb dieses Scopes.
- 2024-09 oder später (empfohlen): Scopes verwenden das Format <scope>.<resource>:<action> (z. B. public.address:read). Dies gibt Ihnen eine granulare Kontrolle.
So erstellen Sie eine API-Integration
- Melden Sie sich bei Ihrem Easyship-Konto an unter app.easyship.com
- Klicken Sie in der Seitenleiste unter Verbinden auf Neue Integration
- Klicken Sie unten auf der Seite auf API-Integration
- Füllen Sie die Details aus und wählen Sie Ihre bevorzugte API-Version
- Klicken Sie auf Verbinden
So zeigen Sie Scopes an oder bearbeiten sie
- Melden Sie sich bei Ihrem Easyship-Konto an unter app.easyship.com
- Wählen Sie Ihre API-Verbindung unter dem Tab Verbinden in der Seitenleiste aus
- Unter API-Zugriffstoken sehen Sie, auf welche Scopes das Token Zugriff hat
- Um Änderungen vorzunehmen, klicken Sie auf Bearbeiten, wählen oder deaktivieren Sie Scopes nach Bedarf und klicken Sie dann auf Speichern
Wenn Sie Zugriff auf zusätzliche Scopes für erweiterte Funktionen oder Beta-Features benötigen, kontaktieren Sie Ihren Account Manager oder wenden Sie sich über Easyship Support an uns.
Ihre Nutzung anzeigen
- Melden Sie sich bei Ihrem Easyship-Konto an
- Gehen Sie zu Abonnement in Ihren Kontoeinstellungen
- Wählen Sie den Tab API-Nutzung
Hier sehen Sie:
- Alle Endpunkte, die in Ihrem Plan enthalten sind
- Verbrauchte Aufrufe im Vergleich zu Ihrem enthaltenen Limit pro Endpunkt
- Aufgelaufene Zusatzgebühren für den aktuellen Zeitraum
- Genutzte API-Aufrufe aufgeschlüsselt nach einzelnen API-Verbindungen
- Welche Plattformen verbunden und welche APIs aktiv sind
Nutzungsdaten werden ungefähr alle 15 Minuten aktualisiert.
Ihre Rechnung verstehen
API-Nutzungsgebühren erscheinen als Positionen auf Ihrer Monatsrechnung mit einer detaillierten Aufschlüsselung, die zeigt:
- API-Aufrufe pro Endpunkt
- Enthaltene Nutzung vs. Zusatznutzung
- Gesamtkosten pro Endpunkt
Um Ihre Rechnungen einzusehen, gehen Sie zu Abonnement > Abrechnung in Ihren Kontoeinstellungen.
FAQs
Wird mein Zugang blockiert, wenn ich mein Limit erreiche?
Nein. Ihre Integration funktioniert weiterhin ohne Unterbrechung. Zusatzgebühren für Aufrufe über Ihr enthaltenes Limit werden auf Ihrer nächsten Monatsrechnung ausgewiesen.
Werde ich benachrichtigt, wenn ich mich meinem Limit nähere?
Ja. Sie erhalten Benachrichtigungen bei 90 % und 100 % Ihrer enthaltenen Nutzung für jeden Endpunkt.
Ich habe einen Jahresplan – warum erhalte ich monatliche Gebühren?
API-Nutzungsgebühren werden monatlich abgerechnet, unabhängig von Ihrem Abonnementtyp. Diese sind getrennt von Ihrer jährlichen Abonnementgebühr und erscheinen als separate Positionen jeden Monat.
Was passiert, wenn ich meinen Plan downgradiere?
Ihre enthaltenen API-Limits passen sich sofort an Ihr neues Plan-Level an. Wenn Sie Scopes verwendet haben, die nur in einem höheren Tarif verfügbar sind, verlieren Sie den Zugriff auf diese. Eine neue Abrechnungsperiode beginnt mit Ihrem neuen Plan.
Zahlen Enterprise-Kunden für die API-Nutzung?
Nein. Die API-Nutzung bei Enterprise-Kunden wird zur Übersicht erfasst, aber nicht berechnet.
Ich benötige mehr API-Aufrufe als in meinem Plan enthalten sind. Was sind meine Optionen?
Wenn Ihre Nutzung regelmäßig die enthaltenen Limits Ihres Plans überschreitet, sollten Sie ein Upgrade Ihres Abonnements in Betracht ziehen. Wenn Standardpläne Ihrem Volumenbedarf nicht gerecht werden, kontaktieren Sie unser Team – wir können einen individuellen Plan erstellen, der auf Ihre Anforderungen zugeschnitten ist.
Was passiert, wenn keine Zahlungsmethode hinterlegt ist?
Für den Zugriff auf kostenpflichtige Endpunkte ist eine gültige Zahlungsmethode erforderlich. Wenn keine hinterlegt ist, sehen Sie die Fehlermeldung: „Zahlungsmethode für kostenpflichtigen Endpunktzugriff erforderlich.“ Fügen Sie in Ihren Abrechnungseinstellungen eine Zahlungsmethode hinzu, um den Zugriff wiederherzustellen.
Was passiert, wenn meine Abonnementzahlung fehlschlägt?
Wenn Ihre Zahlung fehlschlägt, kann der Zugriff auf kostenpflichtige Endpunkte eingeschränkt werden. Aktualisieren Sie Ihre Zahlungsmethode in den Abrechnungseinstellungen und versuchen Sie die Zahlung erneut oder kontaktieren Sie unser Support-Team für Hilfe.