Limiten, Verbrauch und Nachverfolgung

Monatliche Anfragekontingente#

Das Kontingent wird vom Arbeitsbereich geteilt und monatlich in UTC zurückgesetzt. Prüfen Sie /me, Antwortheader und Einstellungen → API → Verbrauch für die effektiven Grenzen einschließlich Arbeitsbereichsanpassungen.

Anfragen über Worker dosieren#

Standardgrenzen sind 120 Anfragen/Minute und 5.000/Stunde pro Schlüssel sowie 600/Minute pro Arbeitsbereich. Der Betreiber kann sie anpassen. Verteilung auf Schlüssel umgeht nicht die Arbeitsbereichsgrenze. Ungültige Schlüssel haben ein eigenes IP-basiertes Missbrauchslimit.

• X-RateLimit-Limit, X-RateLimit-Remaining und X-RateLimit-Reset beschreiben das strengste aktive Zeitfenster.
• X-RateLimit-Reset enthält Sekunden bis zum Reset, keinen Unix-Zeitstempel.
• X-Quota-Limit, X-Quota-Remaining und X-Quota-Reset beschreiben das Monatskontingent. Der Reset ist ein ISO-Zeitstempel.
• Unbegrenzte Kontingente lassen Limit- und Remaining-Header aus. Ratenheader fehlen, wenn alle Ratenfenster deaktiviert sind.
• 429-Antworten enthalten Retry-After. Beachten Sie es statt ständig neu anzufragen.

Was als Anfrage zählt#

Eine zugelassene authentifizierte Anfrage zählt, auch wenn der Handler später ungültige Eingaben ablehnt, eine idempotente Antwort wiedergibt oder fehlschlägt. Ablehnungen bei Zulassung wegen Schlüssel, Berechtigungen, Umfang, Rate oder Kontingent zählen nicht. Die Release-Sperre wird nach Zulassung geprüft und zählt. Öffentliche Metadaten- und OpenAPI-Aufrufe zählen nicht. Gleichzeitige Anfragen können die Monatsgrenze leicht überschreiten; planen Sie nicht mit dieser Überschreitung.

Verbrauch und Änderungen prüfen#

Einstellungen → API enthält Schlüssel, Verbrauch und Anfrageprotokoll. Prüfen Sie Kennungen, Methoden, Pfade, Status und Laufzeiten; Protokolleinträge bleiben 14 Tage gespeichert. Mitglieder sehen eigene Schlüsselaktivität; Administratoren mit api.manage können den ganzen Arbeitsbereich prüfen.

• API-Änderungen stehen im Audit-Trail als API · <Schlüsselname>, dem Eigentümer zugeordnet.
• Speichern Sie X-Request-Id in Betriebslogs, ohne das Bearer-Geheimnis zu protokollieren.
• Anfragepfade und Zeiten helfen der Diagnose; Auditeinträge erklären die tatsächlichen Datensatzänderungen.

Änderungen an ein anderes System senden#

Es gibt keinen REST-Endpoint für Webhook-Abonnements. Konfigurieren Sie in Squario eine Automation mit Datensatztrigger und Webhook-Aktion für Ihren HTTPS-Empfänger. Der Empfänger kann benötigte Datensätze über diese API abrufen. Nutzen Sie die Automationskonfiguration für ausgehenden Payload und Zugangsdaten.