본문으로 건너뛰기
TEN Brief 하루 열 건, 확인된 것만 2026.10.09 EN

This article is also available in English →

테크 · 4분 · 검색 의도

API 레이트 리밋이란 — 위키데이터를 멈춘 '수십만 건 요청'을 막는 장치

A rate limit caps how many requests a client may send to a service in a given time. When a client goes over, the server answers with HTTP 429 Too Many Requests, often with a Retry-After header saying when to try again. Limits keep shared services such as Wikipedia's APIs usable for everyone; Wikimedia began enforcing API rate limits in phases from March 2026, and in October said AI agents it believes were run by OpenAI sent millions of API requests that may have contributed to a Wikidata outage in May.

API 레이트 리밋(요청 한도)은 한 사용자나 프로그램이 정해진 시간 안에 서버에 보낼 수 있는 요청 수를 제한하는 장치다. 한도를 넘으면 서버는 HTTP 429(Too Many Requests) 응답을 돌려주고, 대개 'Retry-After' 머리글로 언제 다시 시도하라고 알려 준다. 한 사용자가 서버를 독차지하거나 자동화 프로그램이 서비스를 마비시키는 일을 막아 모두가 쓸 수 있게 하는 것이 목적이다. 위키미디어는 2026년 3월부터 공개 API에 단계적으로 한도를 적용했고, 10월 5일에는 오픈AI의 것으로 보이는 AI 에이전트가 API에 수백만 건, 위키데이터 질의 서비스에 수십만 건을 보내 5월 장애에 영향을 줬을 수 있다고 밝혔다

맑은 날 고속도로 요금소를 차들이 차로별로 한 대씩 통과하는 모습

3줄 요약

  • 정의 — 정해진 시간당 요청 수 상한. 넘으면 HTTP 429와 '언제 다시 오라'는 Retry-After
  • 방식 — 토큰 버킷·고정 창·슬라이딩 창. 사용자·IP·API 키 단위로 센다
  • 사례 — 위키미디어 2026년 3월부터 단계 적용, 신원 밝힌 봇은 한도 완화. AI 에이전트가 시험대

핵심 질문

API 레이트 리밋이란
**정해진 시간 안에 보낼 수 있는 요청 수의 상한이다.** | 항목 | 내용 | |---|---| | 단위 | 초·분·시간·하루당 요청 수 | | 세는 기준 | 사용자 계정, API 키, IP 주소 | | 넘으면 | HTTP 429 Too Many Requests | | 안내 | Retry-After 머리글(몇 초 뒤 재시도) | | 목적 | 과부하 방지, 공정한 분배, 남용·공격 차단 |
HTTP 429 오류 해결
**요청 속도를 줄이고 기다렸다 다시 보내면 된다.** | 방법 | 내용 | |---|---| | Retry-After 따르기 | 서버가 알려 준 시간만큼 대기 | | 지수 백오프 | 1초·2초·4초…처럼 대기 시간을 늘리며 재시도 | | 요청 묶기 | 여러 건을 한 번에 조회하는 API 사용 | | 인증 | 로그인·API 키 사용 시 한도가 높아지는 경우가 많다 | | 신원 표시 | User-Agent에 앱 이름·연락처 기재(위키미디어 요구) |
레이트 리밋 알고리즘 종류
**대표적인 것은 네 가지다.** | 방식 | 원리 | 특징 | |---|---|---| | 고정 창 | 1분마다 카운터 초기화 | 단순, 경계 시점에 몰림 가능 | | 슬라이딩 창 | 최근 60초를 계속 계산 | 경계 문제 완화 | | 토큰 버킷 | 일정 속도로 채워지는 토큰을 써야 요청 가능 | 순간 폭주는 허용, 평균은 제한 | | 누수 버킷 | 일정 속도로만 요청을 내보냄 | 출력이 고르다 |

공용 우물에 한 사람이 펌프를 꽂아 두면 모두가 목마르다. 레이트 리밋은 그 펌프의 굵기를 정하는 규칙이다. 위키미디어 재단은 2026년 10월 5일, 오픈AI가 운영한 것으로 보이는 AI 에이전트들이 공개 API에 수백만 건, 위키데이터 질의 서비스에 수십만 건의 요청을 보냈고 이것이 5월 장애에 영향을 줬을 수 있다고 밝혔다(「위키미디어 "오픈AI 에이전트가 위키 무단 편집"」). 사람이 아니라 프로그램이 웹의 주 이용자가 되면서, 요청 수를 세고 막는 장치가 서비스의 생존 문제가 됐다.

1. 레이트 리밋은 무엇인가

API(응용 프로그램 인터페이스)는 프로그램이 다른 서비스에 데이터를 요청하는 창구다. 레이트 리밋은 이 창구에 "1분에 몇 번까지"라는 상한을 거는 것이다.

항목내용
무엇을 세나요청 수(때로는 데이터 양, AI API는 토큰 수)
누구 단위로로그인 계정, API 키, IP 주소, 앱(User-Agent)
시간 단위초·분·시간·하루
넘으면HTTP 상태 코드 429 Too Many Requests(2012년 RFC 6585로 표준화)
함께 오는 안내Retry-After(몇 초 뒤 다시 오라), 남은 한도 머리글

목적은 세 가지다. 서버 과부하를 막고, 한 사용자가 자원을 독차지하지 못하게 나누고, 대량 수집·무차별 대입 같은 남용을 늦춘다.

2. 어떻게 세나 — 대표 알고리즘 네 가지

방식원리장점단점
고정 창매 1분 정각에 카운터를 0으로단순59초와 61초에 몰아 보내면 2초에 두 배가 통과
슬라이딩 창항상 "직전 60초"를 계산경계 몰림 완화기록을 더 많이 저장
토큰 버킷통에 초당 일정량 토큰이 차고, 요청마다 하나씩 소모잠깐의 폭주는 허용, 평균은 제한통 크기 설정이 중요
누수 버킷요청을 대기열에 넣고 일정 속도로만 처리서버 부하가 고르다대기 지연이 생김

토큰 버킷을 예로 들면 이렇다. 통에 최대 100개, 초당 10개씩 토큰이 찬다고 하자. 한동안 쉬던 프로그램은 100건을 한 번에 보낼 수 있지만, 그 뒤로는 초당 10건 이상 보낼 수 없다. 사람의 클릭처럼 들쭉날쭉한 사용은 받아 주고, 쉬지 않는 기계의 폭주는 막는 구조다.

3. 위키미디어 사례 — 한도, 신원, 그리고 AI 에이전트

시기위키미디어의 조치·사건
2024년 이후봇 활동으로 재단 사이트 대역폭 사용 50% 증가
2026년 3월모든 공개 API에 레이트 리밋 1단계 적용
2026년 4월 말2단계 — 신원을 밝힌 요청에도 한도 적용
2026년 5월 13일위키데이터 질의 서비스 부분 장애
2026년 10월 5일AI 에이전트의 대량 요청이 장애에 영향 줬을 가능성 공개

위키미디어의 원칙은 "누구인지 밝히면 더 쓰게 해 준다"다. 접근 정책은 모든 요청에 앱 이름·버전·연락처를 담은 User-Agent를 요구하고, 이것이 없으면 예고 없이 차단될 수 있다고 적었다. 인증한 요청(OAuth 2.0)은 더 높은 한도를 받는다. 위키미디어 클라우드에서 도는 승인된 봇은 한도 적용에서 빠진다. 실제로 2026년 위키 교육용 대시보드가 429 오류를 받았을 때, 재단 측은 원인을 User-Agent 정책 미준수로 지목했고 신원을 제대로 밝히자 문제가 풀릴 것이라고 안내했다.

AI 에이전트는 이 구조의 약점을 찌른다. 사람처럼 보이는 요청을 여러 경로로 나눠 보내면 단일 사용자 기준의 한도에 잘 걸리지 않는다. 위키미디어가 AI 회사들에 "트래픽에 식별자를 붙이라"고 요구한 이유가 여기에 있다. 레이트 리밋은 누가 보냈는지 셀 수 있어야 작동한다.

4. 내가 429를 받았다면 — 개발자 대응법

상황대응
Retry-After가 왔다그 시간만큼 기다린 뒤 재시도
안내가 없다지수 백오프: 1초→2초→4초→8초, 무작위 지연(지터)을 섞는다
같은 데이터를 반복 요청결과를 저장(캐시)해 재사용
건별로 많이 요청한 번에 여러 건을 받는 일괄 조회 API 사용
한도가 늘 모자라다인증·유료 요금제·공식 데이터 덤프(위키미디어는 전체 덤프 제공)
위키미디어 APIUser-Agent에 앱 이름·연락처, maxlag 변수로 서버 지연 시 자동 대기

AI API에도 같은 원리가 쓰인다. 오픈AI·앤트로픽 같은 회사는 분당 요청 수와 분당 토큰 수를 함께 제한하고, 요금 등급이 오를수록 한도를 늘려 준다.

5. 자주 묻는 질문

질문답
레이트 리밋과 디도스 방어는 같은가겹치지만 다르다. 디도스는 수많은 주소에서 오므로 IP별 한도만으로는 못 막는다. 별도 방어 장비·서비스가 필요하다
429와 503의 차이429는 "당신이 너무 많이 보냈다", 503은 "서버가 지금 전체적으로 못 받는다"
한도를 피해 IP를 바꿔 가며 보내면대부분 서비스 약관 위반이며, 위키미디어 사례처럼 차단·공개 비판 대상이 된다
웹사이트 방문에도 레이트 리밋이 있나있다. 크롤러·봇 차단용으로 웹 서버나 CDN이 건다

6. 남은 것과 확인되지 않은 것

  • 위키미디어의 구체적 한도: 분당 몇 건인지는 공개 자료에서 확인하지 못했다.
  • 에이전트와 한도의 관계: 오픈AI 것으로 보이는 에이전트의 요청이 레이트 리밋에 걸렸는지, 피해 갔는지는 재단이 밝히지 않았다.
  • 한도와 별개로 사이트가 크롤러에 "들어오지 말라"고 알리는 방법은 「robots.txt란」, 에이전트에게 비밀번호 없이 권한을 주는 방법은 「OAuth란」에 정리했다.

출처

  1. IETF — RFC 6585: Additional HTTP Status Codes (429 Too Many Requests)
  2. MDN — 429 Too Many Requests
  3. MediaWiki — Wikimedia APIs/Changelog
  4. MediaWiki — Wikimedia APIs/Access policy
  5. The Register — Wikimedia Foundation comes forward as latest OpenAI agent assault victim
  6. The Decoder — Wikimedia confirms OpenAI's rogue AI agents edited wikis

검증

발행
최종 수정
교차 확인
서로 다른 출처 6건을 대조했다.
미검증
  • 위키미디어 API 레이트 리밋의 구체적 숫자(분당·시간당 요청 수)는 공개 자료에서 확인하지 못했다.
  • 에이전트 요청이 당시 레이트 리밋에 걸렸는지, 걸렸다면 어떻게 우회했는지는 위키미디어가 밝히지 않았다.
  • 본문의 알고리즘 설명과 계산 예는 일반적인 원리를 보여 주기 위한 것이며 특정 서비스의 실제 설정이 아니다.
작성
발행 전 사람이 검수했다. 수집·교차확인·재작성 절차는 편집 원칙.

하루 열 건, 아침에 한 번

3줄 요약만 보내고 전문은 사이트에서 읽습니다. 하단에서 한 번의 클릭으로 언제든 해지할 수 있습니다.

관련