Leadde Logo

Förstå API-rate limits

En kortfattad lektion som förklarar API-rate limits: vad de är, varför de finns, vanliga misstag vid återförsök och effektiva strategier som exponentiell backoff.
LAv Leadde Uppdaterad 22 augusti 2026

Hur en rate limit avgör om din förfrågan går igenom

En rate limit begränsar antalet förfrågningar en klient får skicka inom ett visst tidsfönster och returnerar 429 när gränsen överskrids. Gränsen finns för att förhindra att en klient förbrukar kapacitet som tillhör alla, vilket är anledningen till att det korrekta svaret är att sakta ner snarare än att skicka samma förfrågan igen omedelbart.

Att försöka igen omedelbart är precis vad de flesta första integrationer gör, och det förvandlar ett tillfälligt avslag till ett ihållande sådant. Klienten når gränsen, försöker igen, förlänger tidsfönstret den mäts över och blir strypt mycket längre än vad den ursprungliga burst-belastningen krävde, oftast medan en utvecklare drar slutsatsen att API:et är opålitligt. Din egen limitkonfiguration – tröskelvärden per nivå, burst-gränser och slutpunkter med snävare gränser – är medvetet exkluderad här, då den hör hemma i versionshanterad dokumentation snarare än i en video som åldras.

Mallen följer en förfrågan genom åtta scener: en om varför gränser överhuvudtaget existerar, en om tidsfönstret och hur det räknas, en om vad ett 429-svar innehåller, två om backoff och varför fördröjningen måste öka, en om jitter och 'thundering herd'-problemet, en om att läsa rate limit-headers, och en om att designa så att gränsen sällan nås.

Så täcker du backoff på under två minuter

Utvecklarutbildning konkurrerar med den dokumentation tittaren redan har öppen. Allt som upprepar referenssidan stängs inom tjugo sekunder, så modulen måste förmedla det enda som dokumentationen kommunicerar dåligt, nämligen felmönstret snarare än parametern.

Visa återförsöksstormen före lösningen

Visa återförsöksstormen före lösningen

En klient som försöker igen var 200:e millisekund mot en gräns den redan har överskridit är hela problemet, synligt i en scen. Backoff framstår då som den självklara lösningen snarare än som en rekommendation.

Tydliggör fördubblingen

En sekund, två, fyra, åtta. Att ange progressionen är snabbare än att definiera exponentiell backoff och är vad en utvecklare faktiskt implementerar.

Ge jitter dess egen stund

Utan randomisering försöker varje strypt klient igen samtidigt och återhämtningsförsöket blir nästa avbrott. Detta är den del de flesta integrationer missar och anledningen till att modulen existerar.

Fokusera på headers snarare än siffrorna

Gränser ändras; headers som rapporterar dem gör det inte. Att lära klienten att läsa vad den får veta är bättre än att hårdkoda ett tröskelvärde som kommer att vara fel nästa kvartal.

Hämta det från den API-dokumentation du redan publicerar

Ladda upp API-dokumentationen, integrationsguiden som skickats till partners, eller supportärendena från den senaste onboardingen — max 200 MB, som PDF, DOC, DOCX, PPTX eller TXT. Scenerna blir redigerbara, originaldokumentet lämnas orört.

Anpassa det till ditt eget API

Använd dina egna headernamn på skärmen

Använd dina egna headernamn på skärmen

Headernamn skiljer sig mellan plattformar, och en utvecklare som visas ett generiskt exempel måste ändå leta upp dina. Att placera de riktiga namnen i scenen tar bort det steget.

Berätta vad som händer efter upprepade överträdelser

Berätta vad som händer efter upprepade överträdelser

Vissa plattformar stryper, vissa stänger av nycklar, vissa kontaktar en människa. Att vara tydlig med konsekvenserna förändrar hur seriöst en partner tar vägledningen.

Styla bildtexterna för termer som måste läsas exakt

Styla bildtexterna för termer som måste läsas exakt

Statuskoder, headernamn och parametervärden missuppfattas lätt men läses tillförlitligt. Välj bland de nio undertextstilarna, behåll samma stil genom hela utvecklarserien och se till att kodtermerna förblir läsbara i små storlekar.

Vanliga frågor om API-rate limits

En rate limit styr hastigheten över ett kort tidsfönster, vanligtvis sekunder eller en minut, och kan återställas genom att vänta. En kvot styr den totala volymen över en faktureringsperiod och är inte återställbar på samma sätt. Att förväxla dem leder till att klienter backar när de egentligen behöver begära en ökning.

Läs värdet för 'retry-after' om ett sådant anges, vänta minst så länge, och försök sedan igen med en fördröjning som ökar vid varje efterföljande misslyckande. Att försöka igen omedelbart eller med ett fast kort intervall förlänger strypningen snarare än att rensa den.

Slutpunktsnamn går bra och gör modulen mer användbar. Nycklar och tokens är det inte, inte ens utgångna sådana, eftersom en träningsvideo cirkulerar utanför den partner den skapades för och lever mycket längre än själva autentiseringsuppgiften.

Eftersom den misslyckade förfrågan fortfarande räknas mot tidsfönstret i de flesta implementeringar. Varje återförsök driver klienten längre förbi gränsen, så den väntetid som krävs för att rensa den växer med varje försök att undvika att vänta.

Stryp det innan produktionen gör det

Kör den API-dokumentation du redan publicerar genom den, och förfina sedan scenerna före nästa partnerintegration.

avatar

Börja med den här mallen. Sluta med en video redo att delas.

Lägg till din onboarding-guide eller hjälpcentersidor och generera ett redigerbart utkast på några minuter.