Avgrens samtidighet når regnskaps-API-et har kvoter
Fordel API-kapasitet etter dokumenterte kvoter og prioritering, uten at store uttrekk stanser nødvendige leveranser.
Kvoter kan gjelde per tilgangsnøkkel, selskap, ressurs eller samlet kunde. En integrasjon med flere arbeidere må derfor koordinere belastningen. Fem prosesser som hver holder sin egen grense, kan samlet overskride leverandørens kvote.
Syntetisk kapasitetsbudsjett
I denne testen tillates 120 forespørsler per minutt. Dette er en oppdiktet kvote og ingen opplysning om ReAI eller andre produkter.
| Oppgave | Planlagt kapasitet per minutt |
|---|---|
| Løpende registrering | 40 |
| Statuskontroll | 20 |
| Historisk uttrekk | 40 |
| Reserve | 20 |
| Sum | 120 |
Tre uthentingsarbeidere som hver bruker 40 forespørsler, fyller hele kvoten før registrering og statuskontroll starter. Et felles kapasitetsbudsjett gjør prioriteringen synlig. Historisk uttrekk kan vente; en avstemming med kort frist kan ha høyere prioritet.
Les kvotesvaret riktig
HTTP-status 429 beskrives i RFC 6585. Leverandørens dokumentasjon må forklare kvotens omfang og eventuell ventetid. En respons med Retry-After bør håndteres etter sin dokumenterte betydning; ikke oversett den til en vilkårlig pause på ett sekund.
Skill kvoteavvisning fra feil i innholdet. Et manglende obligatorisk felt blir ikke riktig av å vente. En uavklart skriveoperasjon må dessuten undersøkes før ny sending, selv om en senere statuskontroll får kvoteavvisning.
Legg inn variasjon i gjenforsøkenes ventetid, slik at alle arbeidere ikke våkner samtidig og skaper en ny belastningstopp. Sett en øvre grense for venting og antall forsøk. Når fristen er nådd, skal jobben få synlig delstatus og ansvarlig oppfølging.
Beslutningspunkter i drift
- Kartlegg alle integrasjoner som deler kvoten.
- Mål normalbelastning og lengden på køen i syntetisk test.
- Prøv samtidig historisk uttrekk og løpende registrering.
- Dokumenter prioritet, maksimal ventetid og stoppregel.
- Kontroller at redusert kapasitet ikke flytter vannmerket forbi ubehandlede data.
Velg høyere samtidighet bare når den gir bedre gjennomføringstid uten flere avvisninger eller dårligere prioritering. Den teoretiske kvoten er ikke nødvendigvis et godt mål for vedvarende drift; svartid og andre tjenester påvirker kapasiteten.
Kølengde alene forteller heller ikke hvor lenge eldste hendelse har ventet. Mål ventetid per prioritetsklasse, så små hastejobber ikke forsvinner bak et stort historisk uttrekk. En dokumentert maksimal ventetid gjør avvik mulig å følge opp.
Et månedlig uttrekk kan også planlegges i flere avgrensede vinduer. Vinduene må ha entydige grenser og samlet kontroll, så kapasitetsstyringen ikke fører til hull i datagrunnlaget. Se trinnvis uthenting for kontroll av slike grenser.