Utvecklarreferens

Begränsningar

DomScan API för domänanalys: Varje autentiserad respons, lyckad eller med fel, innehåller dessa huvuden, och webbläsare kan läsa dem via CORS.

Begränsningar

  • Gratis konton: 300 begäranden per minut, med en burst på 60. Denna budget delas av alla API-nycklar och instrumentpanelsessioner på kontot.
  • Betalda konton: 900 begäranden per minut, med en burst på 120. Denna budget delas av alla API-nycklar och instrumentpanelsessioner på kontot.
  • Enterprise- och månatliga högvolymsplaner: Anpassade gränser som vi kommer överens om med dig utifrån din arbetsbelastning. Medan en sådan är aktiv innehåller X-RateLimit-Policy värdet custom och anger den överenskomna hastigheten och burst. Prata med försäljning
  • Begäranden utan API-nyckel: 600 begäranden per minut och IP-adress, med en burst på 20.
  • Bulk-slutpunkter på gratis konton: Ytterligare 20 begäranden per minut per konto och 100 per minut per nätverk.
  • Cachade begäranden (prefer_cache=1): Räknas fortfarande mot din hastighetsgräns, men de svarar snabbare och hoppar över uppströmskontroll.
  • Masslutpunkt: 50 domäner per begäran
  • TLD:er per begäran: 50 maximum
Om du överskrider en gräns returneras HTTP 429 med en Retry-After-huvud. Varje autentiserad respons innehåller X-RateLimit-Limit, X-RateLimit-Remaining och X-RateLimit-Policy, så att du kan spåra din återstående budget istället för att gissa.

Rate limit-huvuden

Varje autentiserad respons, lyckad eller med fel, innehåller dessa huvuden, och webbläsare kan läsa dem via CORS. Använd dem för att anpassa takten på dina begäranden i stället för att vänta på en 429.

HuvudVad det talar om
X-RateLimit-PlanVilken gräns som gäller: free, paid eller standard för begäranden utan API-nyckel.
X-RateLimit-LimitDin burstkapacitet: hur många begäranden du kan skicka på en gång.
X-RateLimit-RemainingHur många begäranden du fortfarande kan skicka just nu innan gränsen börjar gälla.
X-RateLimit-ResetUnix-tid i sekunder då din burstkapacitet är full igen.
X-RateLimit-PolicyDen fullständiga policyn i maskinläsbar form, till exempel paid; sustained=900; burst=120; scope=account; window=60.
Retry-AfterSkickas med HTTP 429: hur många sekunder du ska vänta innan du försöker igen.