Limieten, verbruik en observability

Maandelijkse verzoekquota#

Het quotum is gedeeld door de werkruimte en wordt maandelijks in UTC gereset. Bekijk /me, antwoordheaders en Instellingen → API → Verbruik voor de effectieve limieten, inclusief werkruimteaanpassingen.

Verzoeken spreiden over workers#

Standaard geldt 120 verzoeken/minuut en 5.000/uur per sleutel, plus 600/minuut per werkruimte. De operator kan limieten aanpassen. Verkeer over sleutels spreiden omzeilt de werkruimtelimiet niet. Ongeldige sleutels hebben een afzonderlijk IP-gebaseerd misbruikbudget.

• X-RateLimit-Limit, X-RateLimit-Remaining en X-RateLimit-Reset beschrijven de strengste actieve limiet.
• X-RateLimit-Reset is het aantal seconden tot reset, geen Unix-tijdstempel.
• X-Quota-Limit, X-Quota-Remaining en X-Quota-Reset beschrijven het maandquotum. De reset is een ISO-tijdstempel.
• Onbeperkte quota laten limit- en remaining-headers weg. Snelheidsheaders ontbreken wanneer alle snelheidslimieten zijn uitgeschakeld.
• 429-antwoorden geven Retry-After. Gebruik die in plaats van voortdurend opnieuw te vragen.

Wat als verzoek telt#

Een toegelaten geauthenticeerd verzoek telt, ook wanneer de handler vervolgens ongeldige invoer weigert, een idempotent antwoord herhaalt of faalt. Weigeringen bij toelating voor sleutel, rechten, scope, snelheid of quotum tellen niet. Een releasebeperking wordt na toelating gecontroleerd en telt wel. Openbare metadata en OpenAPI tellen niet. Gelijktijdige verzoeken kunnen de maandgrens iets overschrijden; ontwerp niet rond die overschrijding.

Verbruik en wijzigingen bekijken#

Instellingen → API bevat Sleutels, Verbruik en Verzoeklog. Bekijk verzoek-ID’s, methodes, paden, statussen en looptijden; logitems worden 14 dagen bewaard. Leden zien hun eigen sleutelactiviteit; beheerders met api.manage kunnen werkruimtebrede activiteit inspecteren.

• API-wijzigingen verschijnen in het auditlog als API · <sleutelnaam>, toegeschreven aan de eigenaar.
• Bewaar X-Request-Id in je operationele logs, zonder het bearer-geheim te loggen.
• Verzoekpaden en looptijden helpen bij diagnose; audititems verklaren de daadwerkelijke recordwijzigingen.

Wijzigingen naar een ander systeem sturen#

Er is geen REST-endpoint voor webhookabonnementen. Configureer in Squario een automatisering met recordtrigger en webhookactie die je HTTPS-ontvanger informeert. De ontvanger kan benodigde records via deze API opvragen. Volg de automatiseringsconfiguratie voor de uitgaande payload en inloggegevens.