100 Anfragen pro Minute und Schlüssel, mit X-RateLimit-Limit, -Remaining und -Reset in jeder Antwort; darüber hinaus 429 mit Retry-After.
Das Limit
Jeder Schlüssel darf auf der externen API 100 Anfragen pro Minute stellen, gezählt je Ein-Minuten-Fenster. Jede Antwort enthält die Header X-RateLimit-Limit (die Obergrenze), X-RateLimit-Remaining (wie viele noch ins Fenster passen) und X-RateLimit-Reset (wann das Fenster wechselt, in Unix-Sekunden).
Oberhalb der Grenze lautet die Antwort 429 mit dem Header Retry-After, der angibt, in wie vielen Sekunden Sie es erneut versuchen können, und dieselbe Information steht im Body für Clients, die keine Header lesen.
Unter dem Limit bleiben
Lesen Sie X-RateLimit-Remaining und drosseln Sie, wenn der Wert niedrig wird. Verteilen Sie bei großen Erstladungen (Anlage von Hunderten Mitarbeitern) die Aufrufe zeitlich oder teilen Sie sie in Pakete pro Minute auf. Paginierte Abfragen zählen eine Anfrage pro Seite.
Scopes
Scopes folgen dem Format Ressource:Aktion und gelten pro Endpunkt: employees:read zum Auflisten und Lesen von Mitarbeitern, employees:write zum Anlegen und Aktualisieren, payroll:read für Perioden und Abrechnungen, payroll:write zum Eröffnen einer Periode, Berechnen, Genehmigen und Als-bezahlt-Markieren, departments und positions lesend und schreibend, timeclock:read und timeclock:write für Zeiteinträge sowie reports:read für Berichte. Ein Schlüssel ohne den Scope erhält 403, und kein Scope erlaubt das Löschen von Daten über die API.