Rate Limits

Limits

Limit	Punkte
Pro Konto und Minute	300
Pro Konto und Tag	10.000
Pro API-Schlüssel und Minute	120

Die Limits pro Konto gelten für alle Schlüssel und alle verbundenen KI-Apps zusammen.

Was ein Aufruf kostet

Aufruf	Punkte
Lesen	1
Ändern	3
Aktion, die eine Bestätigung braucht	5
Auswertung (Umsatz, Abos, Besuche), Kundensuche mit paid_only oder Datei-Upload (POST /v1/files)	10

Gleichzeitige Aufrufe

Ein Konto kann höchstens 8 Aufrufe gleichzeitig ausführen. Davon dürfen höchstens 2 Auswertungen, Kundensuchen mit paid_only oder Datei-Uploads sein. Weitere Aufrufe bekommen den Status 429 mit dem Code busy und einem Header Retry-After.

Limits für einzelne Aktionen

Dazu kommen eigene Limits für einzelne Aktionen:

• Test-E-Mails: 10 pro Stunde und 30 pro Tag.
• Feedback: 10 pro Tag.
• Bestätigungen: höchstens 50 Anfragen pro Konto und Tag.

Wenn ein Limit erreicht ist

Die API antwortet mit dem Status 429 und dem Code rate_limited. Der Header Retry-After nennt die Sekunden, die du warten sollst. Die Nachricht lautet:

Rate limit reached. Wait N seconds, or ask for fewer items per call.

Jeder Aufruf kostet mindestens 1 Punkt, auch wenn Tentary ihn abweist: zum Beispiel wegen eines unbekannten Parameters, eines Bodys, der nicht zum Schema passt, eines Bodys über 1 MB oder eines Limits. Ein Aufruf, den das Minuten- oder Tageslimit abweist, kostet nur diesen 1 Punkt. Ein Aufruf, der später abgewiesen wird, zum Beispiel durch das Limit für Test-E-Mails oder eine Prüfung der Werte, zählt seine vollen Punkte.

Warte nach einem 429 die Sekunden aus Retry-After. Wiederhole den Aufruf nicht sofort in einer Schleife: Auch jeder abgewiesene Aufruf kostet 1 Punkt.

Tipp: Hole bei Listen mit limit mehr Einträge pro Seite, statt viele kleine Seiten abzurufen. Siehe Pagination.