Nutzungsgrenzen

Grenzen gibt es, damit eine ausser Kontrolle geratene Schleife bei einer Integration nicht den Dienst für alle anderen beeinträchtigt. Sie sind so bemessen, dass ein normales Unternehmen ihnen nie begegnet.

Was enthalten ist

Grenze	Wert
Anfragen pro Kalendermonat	25 000
Anfragen pro Minute (Spitze)	60

Die Minutengrenze fängt Ausreisser ab — eine Schleife ohne Abbruchbedingung, ein schlecht geschriebener Wiederholungsversuch. Die Monatsgrenze ist die, die Ihrer tatsächlichen Nutzung entspricht.

Der Testmodus wird getrennt gezählt. Er unterliegt denselben Grenzen, schmälert aber niemals Ihr Live-Kontingent: Ausprobieren kostet nichts.

Was bei Annäherung an die Grenze geschieht

Wir schalten den Dienst bei 100 % nicht ab. Ein harter Stopp würde ein kaufmännisches Gespräch in einen Produktionsausfall verwandeln — und zwar genau bei den Unternehmen, deren Geschäft wächst.

Stattdessen:

Sie werden bei 50 %, 80 % und 100 % Ihres Monatskontingents benachrichtigt.
Über 100 % hinaus sind 20 % Überschreitung erlaubt — einmal pro Kalendermonat. Ihre Aufrufe laufen weiter.
Ist diese Überschreitung aufgebraucht, werden Aufrufe bis zum Folgemonat abgewiesen.

Die Toleranz erneuert sich innerhalb desselben Monats nicht: Sie soll Ihnen Zeit geben, uns anzurufen, nicht dauerhaft oberhalb Ihrer Grenze Platz schaffen.

Wenn eine Grenze erreicht ist

Die Antwort ist ein 429, mit den Headern, die sagen, was zu tun ist:

HTTP/1.1 429 Too Many Requests
Retry-After: 30
Tay-RateLimit-Limit: 60
Tay-RateLimit-Remaining: 0
Tay-RateLimit-Reset: 1758186794

Zwei Codes, weil die beiden Fehler unterschiedliche Reaktionen verlangen. rate_limited heißt: langsamer machen und erneut versuchen; quota_exceeded heißt: der Monat ist aufgebraucht, und ein erneuter Versuch hilft erst nach dem Zurücksetzen.

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests: the limit is 60 per minute."
  }
}

{
  "error": {
    "code": "quota_exceeded",
    "message": "The monthly quota of 25000 requests, and the overage allowance on top of it, are spent."
  }
}

Beide tragen einen Link: <…>; rel="help"-Header, der auf die Seite für eine höhere Grenze verweist. Es gibt keine Selbstbedienungs-Erhöhung — siehe unten.

Halten Sie Retry-After ein, statt sofort erneut zu senden. Ein Client, der auf ein 429 hin weiterhämmert, verbraucht nur seine eigene Toleranz schneller.

Den eigenen Verbrauch abfragen

curl https://staging.tayo.pro/api/v1/usage \
  -H "Authorization: Bearer tay_live_ihr_schluessel"

{
  "mode": "live",
  "period": "2026-09",
  "resetAt": "2026-10-01T00:00:00.000Z",
  "limits": { "monthlyRequests": 25000, "burstPerMinute": 60, "source": "default" },
  "month": { "used": 12483, "remaining": 12517, "state": "within" }
}

state ist within unterhalb des Kontingents, overage innerhalb der einmaligen Toleranz und exhausted, sobald Anfragen abgelehnt werden. source zeigt override, wenn Ihr Unternehmen eine ausgehandelte Grenze statt des veröffentlichten Standards hat.

Sie erhalten den Modus des vorgelegten Schlüssels: Ein tay_test_…-Schlüssel meldet die Testnutzung, niemals Live-Zahlen.

Dieser Endpunkt zählt nicht gegen das Monatskontingent und wird von ihm nie abgelehnt — er ist der einzige Aufruf, der noch antwortet, wenn das Kontingent aufgebraucht ist.

Der Verbrauch und Ihre fehlgeschlagenen Anfragen der letzten 30 Tage sind auch unter Einstellungen → API sichtbar.

Wenn Sie mehr brauchen

Sprechen Sie uns an. Die Grenze wird pro Unternehmen angehoben, ohne dass Sie an Ihrem Code etwas ändern müssen, und wir vereinbaren gemeinsam einen Preis, der zu Ihrem Volumen passt.

Es gibt kein Stufenraster zur Auswahl: Intensive Nutzungen unterscheiden sich zu stark voneinander, als dass ein Raster ihnen gerecht würde.

Dieses Gespräch ist kommerziell, kein Support: Es wird nie berechnet — siehe Support.