Der Retry-After-Header: wie lange gewartet werden soll, bevor Sie den Vorgang wiederholen

Retry-After ist ein HTTP-Antwortheader, der Ihrer App angibt, wie lange gewartet werden soll, bevor sie die nächste Anforderung sendet. Der Wert ist entweder eine Anzahl von Sekunden oder ein HTTP-Datum. Wenn sie von einer API gesendet wird, ist dies die zuverlässigste Antwort auf "wann kann ich es erneut versuchen?", da sie von dem Server stammt, der Ihre Anfrage abgelehnt hat. Weitere Informationen finden Sie unter RFC 9110, Abschnitt 10.2.3.

Wie Retry-After aussieht

Die Kopfzeile hat 2 Formate. Ihre App muss beides verarbeiten.

Server senden Retry-After mit diesen Statuscodes:

Die Kopfzeile ist optional. Einige APIs verwenden stattdessen eigene Header. Beispielsweise informiert GitHub Sie, wenn Ihr Grenzwert zurückgesetzt wird.x-ratelimit-reset Weitere Informationen finden Sie unter GitHub API-Ratelimit überschritten.

Behandeln von Retry-After

1. Lesen Sie beide Versionen. Wenn der Wert eine Zahl ist, ist sie in Sekunden angegeben. Interpretieren Sie sie andernfalls als Datum, und subtrahieren Sie den aktuellen Zeitpunkt. Wenn sich das Datum bereits in der Vergangenheit befindet, können Sie den Vorgang sofort wiederholen.
2. Warten Sie mindestens so lange, wie in der Überschrift angegeben. Wenn Sie es früher erneut versuchen, erhalten Sie in der Regel eine andere 429 oder 503. Einige APIs zählen Ihre Anfragen, während sie Sie drosseln, sodass frühe Wiederholungen die Wartezeit länger machen können. Siehe z. B. Microsoft Graph Anleitung zur Drosselung.
3. Greifen Sie auf Backoff mit Jitter zurück, wenn die Kopfzeile fehlt. Verdoppeln Sie die Wartezeit nach jedem fehlgeschlagenen Versuch, fügen Sie einen zufälligen Betrag hinzu, sodass viele Clients nicht zur gleichen Zeit erneut versuchen, und begrenzen Sie die Wartezeit.
4. Begrenzen Sie Ihre Wiederholungsversuche. Geben Sie nach einigen Versuchen den Fehler an den Aufrufer zurück.
5. Überprüfen Sie, ob ein Wiederholungsversuch hilfreich sein kann. Einige APIs geben 429 zurück, wenn Ihr Guthaben oder Ausgabenlimit aufgebraucht ist. Warten behebt das nicht. Ein Beispiel finden Sie unter OpenAI insufficient_quota und credit_balance_exhausted.

function retryDelayMs(response, attempt) {
  const value = response.headers.get('retry-after');
  if (value) {
    const seconds = Number(value);
    const ms = Number.isNaN(seconds) ? Date.parse(value) - Date.now() : seconds * 1000;
    if (!Number.isNaN(ms)) {
      return Math.max(ms, 0);
    }
  }
  // No usable header: exponential backoff with jitter, capped at 30 seconds
  return Math.random() * Math.min(30_000, 1_000 * 2 ** attempt);
}

Was beliebte SDKs tun

Viele SDKs übernehmen Retry-After für Sie, aber nur, bis ihnen die Wiederholungsversuche ausgehen. Dann tritt in Ihrem Code der Fehler auf.

Überprüfen Sie die Dokumentation Ihres SDK auf die genaue Richtlinie, und testen Sie, was nach dem letzten Wiederholungsversuch passiert.

So testen Sie, ob Ihre App Retry-After verarbeitet

Sie erhalten selten eine Retry-After while-Schleife während der Entwicklung, und wenn doch, können Sie ihren Wert nicht steuern. Die Art und Weise, wie Sie dies testen, entscheidet also, ob Sie die Fehler finden, bevor Ihre Benutzer dies tun.

Probieren Sie sie mit Ihrer App aus

Dev Proxy fängt die Anforderungen Ihrer App an die von Ihnen ausgewählten APIs ab und gibt Antworten mit einem Retry-After Header zurück429, während Ihre App die tatsächlichen URLs aufruft. Das RetryAfterPlugin speichert, wann jede gedrosselte Anfrage erneut versucht werden kann. Wenn Ihre App vor diesem Zeitpunkt dieselbe URL aufruft, meldet Dev Proxy dies und drosselt die Anfrage erneut. Das Plugin erfasst nur 429 Antworten.

Legen Sie in der Fehlerdatei für GenericRandomErrorPlugin den Retry-After Wert einer 429 Antwort fest, @dynamic, und Dev Proxy füllt die Anzahl von Sekunden aus und protokolliert sie für Sie.

Um es auszuprobieren, laden Sie eine Voreinstellung herunter, die beide Plugins verwendet, und starten Sie Dev Proxy damit:

devproxy config get openai-throttling
devproxy --config-file "~dataFolder/configs/openai-throttling/.devproxy/devproxyrc.json"

Führen Sie dann Ihre App wie gewohnt aus, und beobachten Sie, was sie tut. Informationen zum Installieren von Dev Proxy finden Sie unter Einrichten von Dev Proxy.

Nächste Schritte

Siehe auch

• 429 Zu viele Anfragen: was das bedeutet und wie man damit umgeht
• Umgang mit API-Drosselung
• Wiederholen nach Plugin
• GenericRandomErrorPlugin
• Testwiederholungen und Timeouts in .NET-Anwendungen