Überspringen zum Inhalt

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.

JSON
{
    "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_page bis 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.