Tulip wendet Ratenbegrenzungen auf Tabellen-APIs an, um ein konsistentes und zuverlässiges Erlebnis zu bieten und eine hohe Leistung sowie Verfügbarkeit auf der Tulip-Plattform zu gewährleisten. Die Ratenbegrenzung wird im Frühjahr 2026 schrittweise auf allen Tulip-Instanzen eingeführt.
Ratenbegrenzungen für Tabellen
Für die Tarife „Essentials“, „Professional“ und „Enterprise“ gelten die folgenden Ratenbegrenzungen pro Tabelle innerhalb eines Arbeitsbereichs.
| API-Kategorie | Wert der Ratenbegrenzung | Endpunkte |
|---|---|---|
| Datensatzschreiben | 10 Schreibvorgänge pro Sekunde pro Tabelle | POST /api/v3/tables/:tableId/records (createRecord) PUT /api/v3/tables/:tableId/records/:recordId (updateRecord) PATCH /api/v3/tables/:tableId/records/:recordId/increment (incrementRecord) |
| Datensatz löschen | 10 Löschvorgänge pro Sekunde pro Tabelle | DELETE /api/v3/tables/:tableId/records (deleteRecords) DELETE /api/v3/tables/:tableId/records/:recordId (deleteRecord) |
| Datensatz lesen (einzeln) | 50 Lesevorgänge pro Sekunde pro Tabelle | GET /api/v3/tables/:tableId/records/:recordId (getRecord) |
| Datensatz abrufen (mehrere) | 10 Lesevorgänge pro Sekunde pro Tabelle | GET /api/v3/tables/:tableId/runAggregation (runAggregation) GET /api/v3/tables/:tableId/records (listRecords) POST /api/v3/tables/:tableId/exportDataset (exportDataset) GET /api/v3/tables/:tableId/count (countRecords) |
:::(Info) NOTE: Some account plans will have custom configurations. This will be communicated to customers by Tulip Support or Customer Success Managers (CSM)
when applicable. If you are unsure, please contact support@tulip.co
:::
Prior to r383, Service Accounts were called "API Tokens".
Wie wird das Limit gezählt?
Ratenbegrenzungen werden pro (Instanz, Tabelle, Operation) durchgesetzt. Alle Dienstkonten auf einer einzelnen Instanz teilen sich denselben Bucket für eine bestimmte Tabelle und Operation – das Anlegen zusätzlicher Dienstkonten erhöht die effektive Ratenbegrenzung nicht.
Woran erkenne ich, dass ich das Ratenlimit erreicht habe?
Benachrichtigungen zu Tabellen-Ratenlimits werden oben auf der Seite jeder Tabelle angezeigt.
Wenn Sie 80 % des Ratenlimits erreichen, wird der folgende Warnbanner angezeigt:
{height="" width=""}Wenn Sie das Ratenlimit erreicht haben, wird der folgende Fehlerbanner angezeigt:
{height="" width=""}Die Warn- und Fehlerbanner beziehen sich auf einen gleitenden 7-Tage-Zeitraum. Sobald Sie den Schwellenwert erreicht haben, bleibt das Banner noch bis zu 7 Tage lang sichtbar, nachdem Ihre Nutzung wieder unter den Schwellenwert gefallen ist. Die Banner zeigen ein Datum für die „letzte Überschreitung“ an, um anzugeben, wann der Schwellenwert zuletzt überschritten wurde
Was mache ich, wenn ich das Ratenlimit überschreite?
- Überprüfen Sie den 429-Fehler. Die Tabelle und helfen Ihnen dabei, festzustellen, warum bei einem bestimmten Dienstkonto Ratenbegrenzungen auftreten.
- Fassen Sie Anfragen nach Möglichkeit zusammen. Angenommen, Sie haben eine App, die Daten für eine Reihe von Tabelleneinträgen abrufen muss. Anstatt für jeden Eintrag eine einzelne Anfrage zu senden, sollten Sie eine einzige Abfrage senden, die alle benötigten Eintrags-IDs (oder Filterkriterien) enthält – und die Ergebnisse dann lokal in der App verarbeiten.
- Speichern Sie die Ergebnisse im Cache. Anstatt häufige Anfragen zu senden, speichern Sie die Daten aus einer früheren Anfrage im Cache. Aktualisieren Sie die Daten dann entweder bei Bedarf (z. B. wenn ein Nutzer die Daten in einer App explizit aktualisieren möchte) oder in regelmäßigen Abständen, die den Ratenbeschränkungen entsprechen.
- Stellen Sie sicher, dass Ihr Skript Anfragen mit Ratenbegrenzung korrekt verarbeitet. Stellen Sie sicher, dass Ihr Skript Benutzeranfragen nach einem 429-Fehler erneut versucht.
:::(Info) NOTE: When calling an API via a connector function, the connector will automatically handle 429 responses, so no additional retry logic is required. External clients — scripts, automations hosted outside Tulip, or connectors calling Tulip's API from other platforms — must implement retry logic themselves.
:::
{{snippet.Haben Sie gefunden, wonach Sie gesucht haben?}}