Zinsbindungen
Wie viele Anfragen jeder API-Schlüssel stellen kann und wie man 429 Antworten verarbeitet.
Public API Status
Die v1-API verwendet unternehmensweit erfasste Trägerschlüssel und erfordert einen aktiven Planzeitraum. Endpunkte für Entwurfs- und Zahlungsberichte senden keine Kundennachrichten. Beispiele verwenden Platzhalter — fügen Sie niemals einen echten Schlüssel in einen freigegebenen Code ein.
Grenzwerte
Jeder API-Schlüssel kann 60-Anfragen pro Minute. Das Limit wird pro Schlüssel gezählt, so dass separate Schlüssel separate Budgets haben.
Die aktive Testphase, Basic- oder Pro-Periode hat auch eine API-Anforderungszulage. Anfragen, die sie verbrauchen, werden pro Unternehmen und Zeitraum gezählt. 403 forbidden; nach seiner Die Zulage ist erschöpft, sie geben 429 rate_limited zurück. GET /v1/usage meldet die aktuelle Zulage, ohne sie zu verbrauchen.
Wenn Sie das Limit erreicht haben
Die API reagiert mit 429 Too Many Requests, dem Standardfehlerkörper und einem Retry-After-Header mit der Anzahl der zu wartenden Sekunden.
{
"error": {
"code": "rate_limited",
"message": "Too many requests."
},
"request_id": "0c998db5-ab69-49f5-8058-227973e19dbc"
}Innerhalb des Limits bleiben
- Warten Sie auf
Retry-After, bevor Sie es erneut versuchen, und fügen Sie Jitter hinzu, wenn sich mehrere Worker einen Schlüssel teilen. - Verwenden Sie
per_pagebis zu 100, um mehr Artikel pro Anfrage zu lesen. - Geben Sie separaten Systemen separate Schlüssel, damit eine beschäftigte Integration eine andere nicht verlangsamt.