Nutzungsgrenzen

Grenzen gibt es, damit eine außer 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 Ausreißer ab — eine Schleife ohne Abbruchbedingung, ein schlecht geschriebenes retry. Die Monatsgrenze ist die, die Ihrer tatsächlichen Nutzung entspricht.

Beide Grenzen gelten pro Unternehmen und pro Modus. Der Testmodus wird getrennt gezählt: Er hat sein eigenes Kontingent, gleich groß, und schmälert 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 er träfe genau die Unternehmen, deren Geschäft wächst.

Stattdessen:

Sie werden bei 50 %, 80 % und 100 % Ihres Monatskontingents benachrichtigt.
Über 100 % hinaus wird eine Überschreitung von 20 % toleriert — 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, sich dauerhaft oberhalb Ihrer Grenze einzurichten.

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 vor dem Zurücksetzen nichts.

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests: the limit is 60 per minute. Retry after 30s, and see https://tayo.pro/contact if you need a higher limit."
  }
}

{
  "error": {
    "code": "quota_exceeded",
    "message": "The monthly quota of 25000 requests, and the overage allowance on top of it, are spent. It resets on 2026-10-01. See https://tayo.pro/contact to agree a higher limit."
  }
}

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

Halten Sie Retry-After ein, statt sofort erneut zu senden. Ein Client, der auf ein 429 hin in einer Schleife wiederholt, verbraucht nur seine eigene Toleranz.

Den eigenen Verbrauch abfragen

curl https://app.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 Aufrufe abgewiesen werden. source zeigt override, wenn Ihr Unternehmen eine ausgehandelte Grenze statt des veröffentlichten Werts hat.

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

Dieser Endpunkt zählt nicht gegen das Monatskontingent und wird von ihm nie abgewiesen: Er ist der einzige Aufruf, der noch antwortet, wenn das Kontingent aufgebraucht ist. Der Minutengrenze unterliegt er weiterhin.

Die Zähler werden pro Kalendermonat geführt, in UTC.

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

Wenn Sie mehr brauchen

Kontaktieren Sie uns, über Hilfe → Team kontaktieren oder auf tayo.pro/contact. 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 API-Support.