Zum Inhalt springen

Einstieg

Anfragelimits

Die Grenzen fangen eine Schleife in einem fremden Programm, bevor sie den Betrieb aufhält. Im gewöhnlichen Betrieb kommt ein Programm nicht in ihre Nähe.

Was Grenze Gezählt je
alle Endpunkte unter /api/ext/v1 600 in der Minute Schlüssel
POST /api/ext/v1/bookings 60 in der Stunde Schlüssel

Gezählt wird gegen den Schlüssel und nicht gegen die Adresse. Zwei Betriebe hinter demselben Anschluss sperren sich nicht gegenseitig aus, und zwei Schlüssel desselben Betriebs haben je ihr eigenes Guthaben.

Die Grenze für neue Buchungen ist enger, weil jede Buchung zwei Aufträge und eine Mail auslöst.

Jede Antwort der offenen Schnittstelle nennt, was vom Guthaben der Minute übrig ist.

Erste Anfrage der Minute200OK

X-RateLimit-Limit
600
X-RateLimit-Remaining
599
X-RateLimit-Reset
1798391160
Antwort anzeigen 16 Zeilen
{
"tenant": {
"slug": "talstation",
"name": "Skiverleih Talstation",
"country": "AT",
"currency": "EUR"
},
"key": {
"id": "01a1c478-a2b4-734d-827a-e37fd88d51e7",
"name": "Hotel Alpenhof"
},
"scopes": [
"day.view",
"booking.edit"
]
}
Kopf Bedeutung
X-RateLimit-Limit Anfragen je Minute
X-RateLimit-Remaining Anfragen, die in diesem Fenster noch gehen
X-RateLimit-Reset Zeitpunkt in Unix-Sekunden, zu dem die älteste Anfrage aus dem Fenster fällt

Das Fenster gleitet: gezählt werden die Anfragen der letzten sechzig Sekunden, nicht die einer Kalenderminute.

Die Antwort ist 429 mit Retry-After in Sekunden.

Antwort429Too Many Requests

Retry-After
46
X-RateLimit-Limit
600
X-RateLimit-Remaining
0
X-RateLimit-Reset
1798391160
{
"error": {
"code": "rate_limited",
"message": "Zu viele Anfragen in kurzer Zeit.",
"status": 429,
"hint": "In 46 Sekunden erneut versuchen.",
"documentation_url": "https://skirent.sumware.at/api/"
}
}

Warten Sie so lange, wie Retry-After sagt, und senden Sie dann erneut. Eine abgewiesene Anfrage hat nichts geändert.

  • Zustellstatus: Ein Abruf der Tour alle paar Minuten reicht. Der Status eines Auftrags ändert sich, wenn ein Fahrer am Haus war.
  • Kurse: Mit since kommt nur, was sich seit dem letzten Abruf geändert hat. Wer nicht abfragen will, lässt sich melden.
  • Stammdaten: Unterkünfte, Katalog und Einstellungen ändern sich selten. Einmal am Tag genügt.

Der MCP-Server und die offenen Endpunkte auf der Domain des Betriebs haben eigene Grenzen. Dort gibt es keinen Schlüssel, gezählt wird je Adresse des Aufrufers.

Was Grenze
/mcp, Server-Karte, Schema des Entwurfs 120 in der Minute
Preis rechnen, POST /api/public/quote 60 in der Minute
Entwurf anlegen, POST /api/agent/drafts und das Werkzeug create_cart_link 30 in der Stunde
Warenkorb teilen, POST /api/public/cart-shares 30 in der Stunde
Prüfcode prüfen, GET /api/public/verify 20 in der Minute

Auch hier ist die Antwort 429 mit Retry-After.