API-quota: volume, tempo en gelijktijdigheid onderscheiden

In het kort

Een uitgeput quotum, een verzoekpiek en te veel lopende handelingen vragen verschillende maatregelen. Lees de afspraken vóór extra pogingen of accounts.

Lege beveiligde gang met servers en netwerken Illustratie · fictieve scène
In dit artikel

De bereikte grens vaststellen

HTTP 429 betekent te veel verzoeken en kan Retry-After bevatten. Telling en bereik hangen af van de dienst. Een laag gemiddelde voorkomt geen overschrijding in een kort tijdvenster.

BegripBegrensde grootheidNuttige actie
QuotumVolume binnen een periodeGedeeld budget plannen.
TempoBinnenkomsten in een kort vensterStartmomenten spreiden.
GelijktijdigheidLopende handelingenGelijktijdig werk begrenzen.
Retry-After: 120120 seconden wachtenDeadline en herhaalbaarheid controleren.

Toegestane vraag plannen

  • Controleer de telsleutel: account, project, gebruiker of route. Controleer tijdzone van herstel, kosten per handeling en gedeelde budgetten.
  • Spreid pieken via een begrensde wachtrij en begrens lopend werk afzonderlijk. Geef annuleringen door en verwijder nutteloze taken.
  • Lees Retry-After als HTTP-datum of wachttijd in seconden. Respecteer dit binnen de totale deadline en gebruik begrensd wachten bij afwezigheid.

Veilig herhalen zonder bescherming te omzeilen

429 bewijst geen veilige herhaalbaarheid. Controleer idempotentie, totale tijd en pogingenaantal. Meet afwijzingen en wachtrijlengte; verminder blijvende overvraag of spreek passende capaciteit af.

Primaire bronnen

Maak misbruik van snelheidslimieten zichtbaar.

Aanvraaglimieten werken beter wanneer ze legitiem gebruik onderscheiden van abnormaal gedrag en een interpreteerbare gebeurtenis genereren. Foutcodes alleen kunnen het begin, de duur en de reikwijdte van een misbruikpatroon verbergen.

  • Registreer drempelwaarde, beslissing, route en minimale context zonder geheimhouding.
  • Correlateer herhaalde weigeringen met effecten op legitieme gebruikers.
  • Test of waarschuwingen leiden tot onderzoek of proportionele aanpassing.

Primaire bron: ACSC and partners — Event logging and threat detection. Verwante methode: lees de praktische gids.