Ratenbegrenzungen

Die Partner-API erlaubt 300 Anfragen pro Minute und Schlüssel. Das Fenster ist eine gleitende Minute, und das Budget gehört zum Schlüssel und nicht zum Restaurant oder zu Ihrem Unternehmen; zwei Deployments mit zwei Schlüsseln haben also zwei Budgets. Der MCP-Endpunkt zieht aus demselben Budget: Ein Tool-Aufruf ist eine Anfrage.

Wer darüber hinausgeht, bekommt 429 mit einem Problemdokument vom Typ rate-limit-exceeded und einem Retry-After-Header, der die Anzahl der Sekunden angibt, bis sich das Budget wieder füllt. Warten Sie sie ab; versuchen Sie es nicht früher erneut, denn eine Anfrage, die zu früh eintrifft, verbraucht Budget, ohne zu gelingen.

Retry-After ist der einzige Budget-Header. Es gibt kein X-RateLimit-Remaining, das Sie beobachten könnten; takten Sie Ihren Client also über den Entwurf und nicht über das Ablesen eines Zählers — die Gewohnheiten unten sind dieser Entwurf.

Bequem darunter bleiben

Drei Gewohnheiten decken fast jede Integration ab:

Fragen Sie volle Seiten an. limit=100 holt denselben Tag an Lieferungen mit einem Viertel der Anfragen, die limit=25 braucht. Was eine Anfrage kostet, ist die Anfrage, nicht die Zahl der Zeilen.

Holen Sie Fotos nur, wenn Sie sie brauchen. Eine Lieferung trägt ein imageCount. Ist es 0, steht hinter dem Foto-Endpunkt nichts, und ihn aufzurufen ist eine Anfrage, die für eine leere Liste draufgeht.

Serialisieren Sie eine Nachladung. Ein Jahr Historie mit zehn parallelen Workern zu durchlaufen ist die eine Form, die zuverlässig ans Limit stößt. Ein einzelner Worker mit limit=100 kommt in ein paar Minuten durch das Jahr eines gut besuchten Restaurants.

Wenn Sie wirklich mehr brauchen

Sagen Sie uns, worin die Last besteht. Das Limit existiert, damit ein einzelner sich schlecht benehmender Client den Dienst nicht für das Restaurant verschlechtert, dessen Daten es sind, und nicht, um Zugriff zu rationieren; eine beschriebene, berechtigte Last ist ein Gespräch, keine Absage.

Die anderen Grenzen, die man kennen sollte

Diese setzt die API durch, statt sie nur zu beschreiben: Wer eine der ersten drei überschreitet, bekommt 429 oder 400, statt stillschweigend abgeschnitten zu werden.