Im Tarif bleiben

Was ein Tag erlaubt

Tagesgrenzen je Schlüssel, aus der Konfiguration, die die Middleware durchsetzt. Rate Limits behandelt die Minutenseite.

MCP-Aufrufe sind eine Untergrenze innerhalb des Anfragelimits, nie ein Zusatzkontingent: die zuerst erreichte Grenze lehnt ab, wie die MCP-Limitseite erklärt. Mehr als 10 Seiten in 90 Sekunden werden ebenfalls abgelehnt. Durchlaufen Sie den Katalog also stetig statt parallel.

Die Aufrufe, die nichts kosten

Es sind zwei, und zusammen entscheiden sie meist darüber, ob ein Tarif passt.

• Ein 304 Not Modified zählt nicht gegen Ihr Tageslimit. Vorhandenes zu revalidieren ist frei, es erneut zu laden nicht. Caching erklärt die Mechanik.
• Eine Antwort aus Ihrem eigenen Cache erreicht uns gar nicht. Beachten Sie das gesendete Cache-Control, und eine stark besuchte Seite schrumpft auf einen Aufruf pro Cache-Lebensdauer.
• Auch eine Webhook-Zustellung ist keine Anfrage von Ihnen, denn wir rufen Sie an. Änderungen zu empfangen statt zu pollen kostet deshalb nichts pro Datensatz, und Den Katalog spiegeln baut darauf auf.

Mehr pro Aufruf verlangen

Dieselbe Seite, dieselben Daten, ein Viertel der Anfragen. Diese Endpunkte gibt es, weil die Schleife, die sie ersetzen, die ist, die jeder zuerst schreibt.

1// Four calls, one page render.2const g17 = await gunspec.firearms.get('glock-g17')3const p226 = await gunspec.firearms.get('sig-sauer-p226')4const m9 = await gunspec.firearms.get('beretta-92fs')5const p320 = await gunspec.firearms.get('sig-sauer-p320')6 7// One call, the same page, and the fields already lined up for a8// table. Up to five ids, as one comma-separated string.9const { data } = await gunspec.firearms.compare({10  ids: 'glock-g17,sig-sauer-p226,beretta-92fs,sig-sauer-p320',11})

• Bis zu fünf Datensätze in einem Aufruf vergleichen, statt jeden einzeln zu holen. Die Felder kommen bereits ausgerichtet zurück.
• Bis zu fünfzig Namen in einem Aufruf auflösen statt einzeln, wie der Resolve-Leitfaden zeigt.
• Mit fields nur anfordern, was Sie rendern, und lieber per_page erhöhen als mehr Seiten zu holen: eine Seite mit hundert kostet eine Anfrage, fünf Seiten mit zwanzig kosten fünf.
• Nehmen Sie den Endpunkt, der Ihre Frage bereits beantwortet (Varianten, ähnliche Modelle, Anbauteile), statt sie aus Liste plus Schleife zusammenzusetzen.

Den stärksten Schlüssel beobachten, nicht den Durchschnitt

Limits gelten je Schlüssel, und die API lehnt einen Schlüssel nach dem anderen ab. Ein kontoweiter Durchschnitt verdeckt also genau den, der gleich zu scheitern beginnt. Der Usage-Endpunkt nennt beides, und dieselben Zahlen stehen in Ihrem Profil.

1// What the account has actually spent, from the same counters2// the caps are checked against.3const { data } = await gunspec.usage.get()4 5if (data.currentMonth.percentage > 80) {6  notify(`${data.currentMonth.used} of ${data.currentMonth.limit} requests used this month`)7}8 9// Watch the busiest key, never the account's sum: the API refuses one10// key at a time, so an average hides the key about to start failing.11const busiest = data.mcp?.busiestKeyToday12if (busiest && busiest.percentage > 80) {13  notify(`${busiest.keyName} is at ${busiest.percentage}% of today's MCP allowance`)14}

Optimieren oder upgraden

Beides ist legitim. Das Signal sagt, worum es tatsächlich geht.