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.
Offene Schnittstelle
Abschnitt betitelt „Offene Schnittstelle“| 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.
Antwortkopfzeilen
Abschnitt betitelt „Antwortkopfzeilen“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.
Überschreitung
Abschnitt betitelt „Überschreitung“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.
Empfehlungen
Abschnitt betitelt „Empfehlungen“- Zustellstatus: Ein Abruf der Tour alle paar Minuten reicht. Der Status eines Auftrags ändert sich, wenn ein Fahrer am Haus war.
- Kurse: Mit
sincekommt 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.
Zugänge ohne Schlüssel
Abschnitt betitelt „Zugänge ohne Schlüssel“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.